@unmap/themes 0.7.0 → 0.9.0

package/README.md

@@ -20,7 +20,7 @@ import { encodeTheme, decodeTheme, validateTheme, ThemeError } from '@unmap/them
 const code = await encodeTheme({
   v: 1,
   name: 'copper',
-  base: 'outdoor',                                  // base | muted | outdoor | decimal | blueprint | blush | orchid | canopy | lagoon
+  base: 'outdoor',                                  // base | muted | outdoor | blueprint | blush | orchid | canopy | lagoon | tropic | sunset | bold | pastel
   light: { basemap: { water: '#9CCFD2' }, route: { color: '#B85C00', width: 4 } },
   dark:  { basemap: { water: '#12303A' }, route: { color: '#FFA24D', width: 4 } },
 })
@@ -31,7 +31,7 @@ const doc = await decodeTheme(code)                 // validated ThemeDoc, or th
 
 ## What is in a theme
 
-- `base` picks the style: `base`, `muted`, `outdoor`, `decimal`, `blueprint`, `blush`, `orchid`, `canopy` or `lagoon`. Each of `light` and `dark` carries
+- `base` picks the style: `base`, `muted`, `outdoor`, `blueprint`, `blush`, `orchid`, `canopy`, `lagoon`, `tropic`, `sunset`, `bold` or `pastel`. Each of `light` and `dark` carries
   sparse overrides on that style, so a theme with no overrides renders exactly like its
   `flavor=` twin.
 - `basemap` overrides are colours on the style's recipe (land, water, vegetation, roads, labels,

package/dist/index.d.ts

@@ -108,6 +108,25 @@ declare const verdant: {
     readonly 800: "#1E4128";
     readonly 900: "#0B2815";
 };
+/**
+ * Leaf green, hue 136: `outdoor`'s vegetation (2026-09-09). `verdant` is a mint that reads cool
+ * and flat once it has to stand for a forest rather than a city park; the outdoor maps people
+ * already read use a yellower, fuller green. Generated from verdant's own lightness step for
+ * step (chroma ×1.6, capped at 0.14 to stay in gamut), so every contrast property the ramps were
+ * solved for carries over and only the hue and chroma move. Outdoor alone; the street styles
+ * keep verdant, where a park is a tint and a mint is right.
+ */
+declare const fern: {
+    readonly 100: "#D3F3C5";
+    readonly 200: "#C3E6B3";
+    readonly 300: "#AFD59E";
+    readonly 400: "#96BF83";
+    readonly 500: "#76A560";
+    readonly 600: "#518535";
+    readonly 700: "#37621E";
+    readonly 800: "#1E4305";
+    readonly 900: "#0F2900";
+};
 /** Warm landcover, hue 82: sand, beach, farmland. */
 declare const sandstone: {
     readonly 100: "#F5E8D0";
@@ -258,6 +277,92 @@ declare const aqua: {
     readonly 950: "#081B1D";
     readonly 980: "#060E0F";
 };
+/** Cream neutrals, hue 90, chroma 0.022: `tropic`'s and `sunset`'s land and labels. `paper`'s ladder. */
+declare const linen: {
+    readonly 25: "#FCF6E6";
+    readonly 50: "#F6F0E0";
+    readonly 100: "#EDE7D7";
+    readonly 200: "#E2DCCC";
+    readonly 300: "#D5CFC0";
+    readonly 400: "#C4BEAF";
+    readonly 500: "#AAA495";
+    readonly 600: "#8B8677";
+    readonly 700: "#696457";
+    readonly 800: "#4B4639";
+    readonly 850: "#383427";
+    readonly 900: "#272317";
+    readonly 950: "#1B170B";
+    readonly 1000: "#0F0B03";
+};
+/** Coral, hue 28, on `rose`'s ladder at 1.3× its chroma: the highway on `tropic`, `sunset` and `pastel`. */
+declare const coral: {
+    readonly 25: "#FFF3F1";
+    readonly 50: "#FFEBE8";
+    readonly 100: "#FFDFDB";
+    readonly 200: "#FFCFC8";
+    readonly 300: "#FFBDB3";
+    readonly 400: "#FFA195";
+    readonly 500: "#F47C6E";
+    readonly 600: "#C76559";
+    readonly 700: "#974A42";
+    readonly 800: "#6C332D";
+    readonly 850: "#512520";
+    readonly 900: "#391814";
+    readonly 950: "#270F0C";
+    readonly 1000: "#170705";
+};
+/** Peach, hue 58, on `verdant`'s ladder: `sunset`'s vegetation, which is not green on purpose. */
+declare const peach: {
+    readonly 100: "#FFE2CC";
+    readonly 200: "#FFCEAA";
+    readonly 300: "#F4B98D";
+    readonly 400: "#E0A171";
+    readonly 500: "#CA8248";
+    readonly 600: "#AC5E0D";
+    readonly 700: "#804300";
+    readonly 800: "#572B00";
+    readonly 900: "#361900";
+};
+/** Indigo, hue 295, on `cobalt`'s ladder at 0.7× its chroma: `sunset`'s water and night, and the boundary purple elsewhere. */
+declare const indigo: {
+    readonly 25: "#F7F6F9";
+    readonly 50: "#F0EFF6";
+    readonly 100: "#E8E6F1";
+    readonly 200: "#DDD9EC";
+    readonly 300: "#D0CBE6";
+    readonly 400: "#C0B8DE";
+    readonly 500: "#A89BD3";
+    readonly 600: "#8B76C5";
+    readonly 700: "#6D4BB5";
+    readonly 800: "#4B3977";
+    readonly 850: "#362C53";
+    readonly 900: "#251F36";
+    readonly 950: "#181422";
+    readonly 1000: "#0C0A11";
+};
+/** Azure, hue 245, on `wave`'s ladder at 1.7× its chroma: `bold`'s clear blue water. */
+declare const azure: {
+    readonly 100: "#D4EBFF";
+    readonly 200: "#B6DDFF";
+    readonly 300: "#92CBFB";
+    readonly 400: "#74B3E8";
+    readonly 500: "#5299D2";
+    readonly 600: "#227AB9";
+    readonly 700: "#005B91";
+    readonly 800: "#003D64";
+    readonly 900: "#002641";
+    readonly 950: "#00192D";
+    readonly 980: "#000E1C";
+};
+/** Amber, hue 85, on `ember`'s ladder: `bold`'s highway. */
+declare const amber: {
+    readonly 200: "#FEEAC1";
+    readonly 300: "#F3C96F";
+    readonly 400: "#E7AF0E";
+    readonly 500: "#C99700";
+    readonly 600: "#C19100";
+    readonly 700: "#916D00";
+};
 
 /**
  * The unmap cartography authoring surface, moved here from apps/gateway/src/flavors.ts so the
@@ -273,10 +378,11 @@ declare const aqua: {
  * the unmap.dev builder, so inserting a style mid-array silently reorders a control people have
  * already learned.
  *
- * `relief` and `street` were retired; they are not listed here. Short preset codes still
- * decode those slots via `normalizeThemeBase` / the slot table in `preset.ts`.
+ * `relief`, `street` and `decimal` were retired; they are not listed here. Short preset codes
+ * still decode those slots via `normalizeThemeBase` / the slot table in `preset.ts`. `decimal`
+ * (2026-09-09) maps onto `blueprint`: the two single-hue styles read as the same map.
  */
-declare const THEME_BASES: readonly ["base", "muted", "outdoor", "decimal", "blueprint", "blush", "orchid", "canopy", "lagoon"];
+declare const THEME_BASES: readonly ["base", "muted", "outdoor", "blueprint", "blush", "orchid", "canopy", "lagoon", "tropic", "sunset", "bold", "pastel"];
 type ThemeBase = (typeof THEME_BASES)[number];
 /** Map a theme `base` — living or retired — onto a shipped style. `null` if unknown. */
 declare function normalizeThemeBase(base: string): ThemeBase | null;
@@ -371,6 +477,7 @@ interface RampSet {
     wave: typeof wave;
     sky: typeof sky;
     verdant: typeof verdant;
+    fern: typeof fern;
     sandstone: typeof sandstone;
     graphite: typeof graphite;
     mist: typeof mist;
@@ -380,6 +487,12 @@ interface RampSet {
     lilac: typeof lilac;
     aqua: typeof aqua;
     ember: typeof ember;
+    linen: typeof linen;
+    coral: typeof coral;
+    peach: typeof peach;
+    indigo: typeof indigo;
+    azure: typeof azure;
+    amber: typeof amber;
 }
 declare const STOCK_RAMPS: RampSet;
 /** Build the shipped recipes from a ramp set. Stock ramps in → the shipped cartography out. */
@@ -522,8 +635,10 @@ declare function decodeTheme(code: string): Promise<ThemeDoc>;
  * enumerated choices that starts at three characters and grows only when the theme leaves the
  * curated set.
  *
- *   u00 … u08       the nine styles, in lineup order
- *   u0W, u4e, …     a named theme preset on a style (three characters for every pair)
+ *   u00 … u0C       the style slots, in lineup order (`u03` was `decimal`, retired 2026-09-09;
+ *                   it decodes to `blueprint`, and `blueprint` still encodes as `u04`)
+ *   u0W, u4e, …     a named theme preset on a style (three characters for every pair, which
+ *                   holds for up to fifteen presets; the sixteenth would take four)
  *   six to eight    a style or preset with layer groups hidden or reordered
  *   up to 23        custom seed colours (4× RGB) on any style, layers included
  *
@@ -663,7 +778,7 @@ declare function contrastWarnings(doc: ThemeDoc): ContrastWarning[];
  * The shipped styles as starting-point themes: zero overrides, so each is guaranteed identical
  * to its `flavor=` twin (asserted in the gateway theme tests). The builder opens on these.
  *
- * Named after the style itself — `base`, `muted`, `outdoor`, `decimal`, `blueprint`, `blush`, … — the same word the homepage, the
+ * Named after the style itself — `base`, `muted`, `outdoor`, `blueprint`, `blush`, … — the same word the homepage, the
  * SDK's `style` option and the gateway URL use. The theme presets (`process ink`, `boreal`, …)
  * are a separate set layered on a style; a style never borrows one's name.
  */
@@ -703,11 +818,12 @@ declare const DEFAULT_SEEDS: Required<ThemeSeeds>;
  *
  * Family mapping: `land` recolours the land spines — `ink`, `base`'s `paper`, `muted`'s
  * `graphite` at a whisper of chroma (that style exists to vanish under data), and the
- * single-hue families of `decimal` (`jade`) and `blueprint` (`cobalt`) at full chroma, so a
- * seed can carry them to any hue, plus `blush`'s `rose` and `orchid`'s `lilac`. `nature`
- * recolours `verdant` and the teal `aqua` of `orchid` and `lagoon`. `water` recolours the wave, sky, and mist ramps (`mist` is
+ * single-hue family of `blueprint` (`cobalt`) at full chroma (and `jade`, which `orchid` and `lagoon` borrow), so a
+ * seed can carry them to any hue, plus `blush`'s `rose`, `orchid`'s `lilac`, the cream `linen` of
+ * `tropic` and `sunset`, and `sunset`'s `indigo`. `nature` recolours `verdant`, `sunset`'s `peach`
+ * and the teal `aqua` of `orchid` and `lagoon`. `water` recolours the wave, sky, azure and mist ramps (`mist` is
  * greyscale in stock `muted` and takes the water seed's hue outright), `nature` the verdant
- * ramp. Warm landcover (sandstone), POI accents and white road fills stay stock: they
+ * ramp. Warm landcover (sandstone), the highway ramps (ember, coral, amber), POI accents and white road fills stay stock: they
  * are tuned relationships, not identity. `accent` styles the marker and route overlays only —
  * it never enters the basemap, same rule as the brand magenta.
  */
@@ -734,4 +850,19 @@ declare const THEME_PRESETS: ThemePreset[];
  */
 declare function shuffleSeeds(rng?: () => number): Required<ThemeSeeds>;
 
-export { BUILDINGS_3D_LAYER_ID, type BasemapOverrides, type ContrastWarning, DEFAULT_LAYER_VISIBILITY, DEFAULT_MARKER, DEFAULT_ROUTE, DEFAULT_SEEDS, type DeepPartial, LABEL_PAIRS, LAYER_GROUPS, type LabelRamp, type LayerGroup, MAX_CODE_LENGTH, MODES, type MarkerTheme, type Oklch, PRESET_CODE_PREFIX, PRESET_CODE_RE, RECIPES, type RampSet, type Recipe, type ResolvedTheme, type RoadRamp, type RouteTheme, STOCK_RAMPS, STYLE_THEMES, THEME_BASES, THEME_CODE_PREFIX, THEME_PRESETS, type ThemeBase, type ThemeDoc, ThemeError, type ThemeHalf, type ThemeLayers, type ThemeMode, type ThemePreset, type ThemeSeeds, applyThemeLayers, aqua, buildRecipes, cobalt, contrast, contrastWarnings, decodePreset, decodeTheme, effectiveLayerOrder, ember, encodePreset, encodeTheme, generateTheme, graphite, hexToOklch, ink, isLayerVisible, isStockLayerOrder, isStockLayers, isThemePresetCode, jade, layerGroupOf, lilac, makeFlavor, mergeRecipe, mist, normalizeThemeBase, oklchToHex, paper, presetId, registryThemeKey, resolveTheme, rose, sandstone, shuffleSeeds, sky, validateTheme, verdant, wave };
+/**
+ * Map an extracted image palette onto the four simple-mode seeds. Deterministic: the same
+ * colours always produce the same seeds, and `generateTheme` then carries the contrast
+ * guarantee. Lightness on land/water/nature is display-only (the generator re-hues stock
+ * ladders); accent is used verbatim for the marker and route.
+ */
+interface PaletteColor {
+    hex: string;
+    proportion: number;
+}
+/**
+ * Brand colours in, the four simple-mode seeds out. Empty input falls back to the stock seeds.
+ */
+declare function seedsFromPalette(colors: PaletteColor[]): Required<ThemeSeeds>;
+
+export { BUILDINGS_3D_LAYER_ID, type BasemapOverrides, type ContrastWarning, DEFAULT_LAYER_VISIBILITY, DEFAULT_MARKER, DEFAULT_ROUTE, DEFAULT_SEEDS, type DeepPartial, LABEL_PAIRS, LAYER_GROUPS, type LabelRamp, type LayerGroup, MAX_CODE_LENGTH, MODES, type MarkerTheme, type Oklch, PRESET_CODE_PREFIX, PRESET_CODE_RE, type PaletteColor, RECIPES, type RampSet, type Recipe, type ResolvedTheme, type RoadRamp, type RouteTheme, STOCK_RAMPS, STYLE_THEMES, THEME_BASES, THEME_CODE_PREFIX, THEME_PRESETS, type ThemeBase, type ThemeDoc, ThemeError, type ThemeHalf, type ThemeLayers, type ThemeMode, type ThemePreset, type ThemeSeeds, amber, applyThemeLayers, aqua, azure, buildRecipes, cobalt, contrast, contrastWarnings, coral, decodePreset, decodeTheme, effectiveLayerOrder, ember, encodePreset, encodeTheme, fern, generateTheme, graphite, hexToOklch, indigo, ink, isLayerVisible, isStockLayerOrder, isStockLayers, isThemePresetCode, jade, layerGroupOf, lilac, linen, makeFlavor, mergeRecipe, mist, normalizeThemeBase, oklchToHex, paper, peach, presetId, registryThemeKey, resolveTheme, rose, sandstone, seedsFromPalette, shuffleSeeds, sky, validateTheme, verdant, wave };