@unmap/themes 0.13.0 → 0.15.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 | blueprint | blush | orchid | canopy | lagoon | tropic | sunset | bold | pastel
+  base: 'outdoor',                                  // base | muted | outdoor | blueprint | blush | orchid | canopy | lagoon | tropic | sunset | bold | pastel | atlas | swiss
   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`, `blueprint`, `blush`, `orchid`, `canopy`, `lagoon`, `tropic`, `sunset`, `bold` or `pastel`. Each of `light` and `dark` carries
+- `base` picks the style: `base`, `muted`, `outdoor`, `blueprint`, `blush`, `orchid`, `canopy`, `lagoon`, `tropic`, `sunset`, `bold`, `pastel`, `atlas` or `swiss`. 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,
@@ -57,5 +57,5 @@ const doc = await decodeTheme(code)                 // validated ThemeDoc, or th
   themes are both built from.
 
 Runs in browsers, Cloudflare Workers, and Node 18 or later (it uses the web `CompressionStream`).
-Docs: [unmap.dev/docs/tiles-and-styles](https://unmap.dev/docs/tiles-and-styles) covers the
+Docs: [unmap.dev/docs/apis/maps](https://unmap.dev/docs/apis/maps) covers the
 `?theme=` parameter and the `invalid_theme` error.

package/dist/index.d.ts

@@ -363,6 +363,89 @@ declare const amber: {
     readonly 600: "#C19100";
     readonly 700: "#916D00";
 };
+/** Bay Atlas reference colours, re-authored as light/dark ramps for Canada's basemap. */
+declare const atlasPaper: {
+    readonly 25: "#F6F3EA";
+    readonly 100: "#EDE7DC";
+    readonly 200: "#DDD4C4";
+    readonly 500: "#A08A70";
+    readonly 700: "#786B5E";
+    readonly 800: "#57504A";
+    readonly 900: "#2A2521";
+    readonly 950: "#211C17";
+    readonly 1000: "#15110D";
+};
+declare const atlasWater: {
+    readonly 200: "#B3D2E6";
+    readonly 400: "#86B3D4";
+    readonly 700: "#3E6D96";
+    readonly 800: "#274F73";
+    readonly 950: "#142B3D";
+    readonly 980: "#0B1C29";
+};
+declare const atlasGreen: {
+    readonly 100: "#E9EFD4";
+    readonly 200: "#DCE8CB";
+    readonly 300: "#CFE4B8";
+    readonly 700: "#3B6B2B";
+    readonly 800: "#2A4822";
+    readonly 900: "#1B3018";
+};
+declare const atlasRoad: {
+    readonly 300: "#F7D686";
+    readonly 400: "#E67F50";
+    readonly 500: "#C8412A";
+    readonly 600: "#A8231C";
+    readonly 800: "#5E1712";
+};
+/** Swiss national-map conventions: white ground, blue water, leaf greens, yellow roads. */
+declare const swissPaper: {
+    readonly 25: "#FDFDFE";
+    readonly 100: "#F2F2F2";
+    readonly 200: "#E6E4E2";
+    readonly 500: "#96938E";
+    readonly 700: "#686660";
+    readonly 800: "#3C3C3C";
+    readonly 900: "#252525";
+    readonly 950: "#191919";
+    readonly 1000: "#101010";
+};
+declare const swissWater: {
+    readonly 200: "#D2EEFF";
+    readonly 400: "#4DA4DA";
+    readonly 700: "#2D78A4";
+    readonly 800: "#205674";
+    readonly 950: "#152F40";
+    readonly 980: "#0A1B28";
+};
+declare const swissGreen: {
+    readonly 100: "#D3EBC7";
+    readonly 200: "#C3DDB4";
+    readonly 300: "#8AC66C";
+    readonly 700: "#48792C";
+    readonly 800: "#2C4E22";
+    readonly 900: "#1B3317";
+};
+declare const swissRoad: {
+    readonly 300: "#FAF39E";
+    readonly 400: "#F8C444";
+    readonly 500: "#FAB69E";
+    readonly 600: "#CB4D4D";
+    readonly 800: "#46371E";
+};
+/** Relief inks from the references; neutral shadows avoid colouring every ridge blue. */
+declare const atlasRelief: {
+    readonly shadow: "#5B4A3B";
+    readonly highlight: "#FFFDF5";
+    readonly accent: "#7C6A58";
+    readonly contour: "#A8875F";
+};
+declare const swissRelief: {
+    readonly shadow: "#4E6276";
+    readonly highlight: "#FFF8CD";
+    readonly accent: "#606C7A";
+    readonly contour: "#B46E0D";
+};
 
 /**
  * The unmap cartography authoring surface, moved here from apps/gateway/src/flavors.ts so the
@@ -382,7 +465,7 @@ declare const amber: {
  * 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", "blueprint", "blush", "orchid", "canopy", "lagoon", "tropic", "sunset", "bold", "pastel"];
+declare const THEME_BASES: readonly ["base", "muted", "outdoor", "blueprint", "blush", "orchid", "canopy", "lagoon", "tropic", "sunset", "bold", "pastel", "atlas", "swiss"];
 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;
@@ -472,6 +555,14 @@ declare function makeFlavor(r: Recipe): Flavor;
  * hand-tuned originals (they are `buildRecipes(STOCK_RAMPS)`).
  */
 interface RampSet {
+    atlasPaper: typeof atlasPaper;
+    atlasWater: typeof atlasWater;
+    atlasGreen: typeof atlasGreen;
+    atlasRoad: typeof atlasRoad;
+    swissPaper: typeof swissPaper;
+    swissWater: typeof swissWater;
+    swissGreen: typeof swissGreen;
+    swissRoad: typeof swissRoad;
     ink: typeof ink;
     paper: typeof paper;
     wave: typeof wave;
@@ -865,4 +956,4 @@ interface PaletteColor {
  */
 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 };
+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, atlasGreen, atlasPaper, atlasRelief, atlasRoad, atlasWater, 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, swissGreen, swissPaper, swissRelief, swissRoad, swissWater, validateTheme, verdant, wave };

package/dist/index.js

@@ -278,6 +278,76 @@ var amber = {
   600: "#C19100",
   700: "#916D00"
 };
+var atlasPaper = {
+  25: "#F6F3EA",
+  100: "#EDE7DC",
+  200: "#DDD4C4",
+  500: "#A08A70",
+  700: "#786B5E",
+  800: "#57504A",
+  900: "#2A2521",
+  950: "#211C17",
+  1e3: "#15110D"
+};
+var atlasWater = {
+  200: "#B3D2E6",
+  400: "#86B3D4",
+  700: "#3E6D96",
+  800: "#274F73",
+  950: "#142B3D",
+  980: "#0B1C29"
+};
+var atlasGreen = {
+  100: "#E9EFD4",
+  200: "#DCE8CB",
+  300: "#CFE4B8",
+  700: "#3B6B2B",
+  800: "#2A4822",
+  900: "#1B3018"
+};
+var atlasRoad = {
+  300: "#F7D686",
+  400: "#E67F50",
+  500: "#C8412A",
+  600: "#A8231C",
+  800: "#5E1712"
+};
+var swissPaper = {
+  25: "#FDFDFE",
+  100: "#F2F2F2",
+  200: "#E6E4E2",
+  500: "#96938E",
+  700: "#686660",
+  800: "#3C3C3C",
+  900: "#252525",
+  950: "#191919",
+  1e3: "#101010"
+};
+var swissWater = {
+  200: "#D2EEFF",
+  400: "#4DA4DA",
+  700: "#2D78A4",
+  800: "#205674",
+  950: "#152F40",
+  980: "#0A1B28"
+};
+var swissGreen = {
+  100: "#D3EBC7",
+  200: "#C3DDB4",
+  300: "#8AC66C",
+  700: "#48792C",
+  800: "#2C4E22",
+  900: "#1B3317"
+};
+var swissRoad = {
+  300: "#FAF39E",
+  400: "#F8C444",
+  500: "#FAB69E",
+  600: "#CB4D4D",
+  800: "#46371E"
+};
+var atlasRelief = { shadow: "#5B4A3B", highlight: "#FFFDF5", accent: "#7C6A58", contour: "#A8875F" };
+var swissRelief = { shadow: "#4E6276", highlight: "#FFF8CD", accent: "#606C7A", contour: "#B46E0D" };
 
 // src/recipe.ts
 var THEME_BASES = [
@@ -292,7 +362,9 @@ var THEME_BASES = [
   "tropic",
   "sunset",
   "bold",
-  "pastel"
+  "pastel",
+  "atlas",
+  "swiss"
 ];
 var RETIRED_BASES = {
   relief: "outdoor",
@@ -391,6 +463,14 @@ function makeFlavor(r) {
 
 // src/recipes.ts
 var STOCK_RAMPS = {
+  atlasPaper,
+  atlasWater,
+  atlasGreen,
+  atlasRoad,
+  swissPaper,
+  swissWater,
+  swissGreen,
+  swissRoad,
   ink,
   paper,
   wave,
@@ -2216,6 +2296,76 @@ function buildRecipes(r) {
       forest: r.fern[800]
     }
   };
+  const traditional = (swiss, mode) => {
+    const light = mode === "light";
+    const land = swiss ? r.swissPaper : r.atlasPaper;
+    const water = swiss ? r.swissWater : r.atlasWater;
+    const green = swiss ? r.swissGreen : r.atlasGreen;
+    const stock = light ? BASE_LIGHT : BASE_DARK;
+    const halo = light ? land[25] : land[1e3];
+    const highway = swiss ? r.swissRoad[400] : light ? r.atlasRoad[600] : r.atlasRoad[400];
+    const casing = light ? swiss ? r.swissRoad[800] : r.atlasRoad[800] : land[1e3];
+    return {
+      ...stock,
+      background: light ? land[25] : land[1e3],
+      earth: light ? land[25] : land[900],
+      water: light ? water[200] : water[980],
+      parkA: light ? green[100] : green[800],
+      parkB: light ? green[200] : green[700],
+      woodA: light ? green[200] : green[800],
+      woodB: light ? green[300] : green[700],
+      scrubA: light ? green[100] : green[900],
+      scrubB: light ? green[200] : green[800],
+      institutional: light ? land[100] : land[950],
+      pedestrian: light ? land[25] : land[950],
+      buildings: light ? land[200] : land[700],
+      railway: swiss ? r.swissRoad[600] : land[700],
+      boundaries: light ? r.lilac[600] : r.lilac[400],
+      roads: {
+        other: light ? land[500] : land[700],
+        otherCasing: light ? land[700] : land[1e3],
+        minor: light ? "#FFFFFF" : land[500],
+        minorCasing: light ? land[700] : land[1e3],
+        service: light ? land[25] : land[700],
+        serviceCasing: light ? land[500] : land[1e3],
+        major: swiss ? r.swissRoad[500] : light ? r.atlasRoad[500] : r.atlasRoad[300],
+        majorCasing: casing,
+        highway,
+        highwayCasing: casing,
+        link: highway,
+        linkCasing: casing
+      },
+      tunnelFill: light ? land[100] : land[950],
+      tunnelCasing: light ? land[500] : land[1e3],
+      bridgeCasing: casing,
+      labels: {
+        city: light ? land[900] : land[25],
+        cityHalo: halo,
+        state: light ? land[700] : land[500],
+        stateHalo: halo,
+        country: light ? land[700] : land[500],
+        subplace: light ? land[700] : land[500],
+        subplaceHalo: halo,
+        address: light ? land[700] : land[500],
+        addressHalo: halo,
+        roadMinor: light ? land[800] : land[500],
+        roadMinorHalo: halo,
+        roadMajor: light ? land[900] : land[200],
+        roadMajorHalo: halo,
+        ocean: light ? water[700] : water[400]
+      },
+      pois: { ...stock.pois, green: light ? green[700] : green[300], blue: light ? water[700] : water[400] },
+      landcover: {
+        grassland: light ? green[100] : green[900],
+        barren: light ? land[200] : land[700],
+        urban_area: light ? land[100] : land[950],
+        farmland: light ? land[25] : land[950],
+        glacier: light ? water[200] : water[950],
+        scrub: light ? green[100] : green[900],
+        forest: light ? green[200] : green[800]
+      }
+    };
+  };
   return {
     base: { light: BASE_LIGHT, dark: BASE_DARK },
     muted: { light: MUTED_LIGHT, dark: MUTED_DARK },
@@ -2228,7 +2378,9 @@ function buildRecipes(r) {
     tropic: { light: TROPIC_LIGHT, dark: TROPIC_DARK },
     sunset: { light: SUNSET_LIGHT, dark: SUNSET_DARK },
     bold: { light: BOLD_LIGHT, dark: BOLD_DARK },
-    pastel: { light: PASTEL_LIGHT, dark: PASTEL_DARK }
+    pastel: { light: PASTEL_LIGHT, dark: PASTEL_DARK },
+    atlas: { light: traditional(false, "light"), dark: traditional(false, "dark") },
+    swiss: { light: traditional(true, "light"), dark: traditional(true, "dark") }
   };
 }
 var RECIPES = buildRecipes(STOCK_RAMPS);
@@ -2411,7 +2563,9 @@ var STYLE_THEMES = {
   tropic: { v: 1, name: "tropic", base: "tropic" },
   sunset: { v: 1, name: "sunset", base: "sunset" },
   bold: { v: 1, name: "bold", base: "bold" },
-  pastel: { v: 1, name: "pastel", base: "pastel" }
+  pastel: { v: 1, name: "pastel", base: "pastel" },
+  atlas: { v: 1, name: "atlas", base: "atlas" },
+  swiss: { v: 1, name: "swiss", base: "swiss" }
 };
 
 // src/oklch.ts
@@ -2654,6 +2808,12 @@ function diffRecipe(stock, generated) {
 function generateTheme(base, seeds) {
   const ramps = {
     ...STOCK_RAMPS,
+    atlasPaper: reRamp(STOCK_RAMPS.atlasPaper, seeds.land, NEUTRAL_CHROMA_CAP),
+    atlasWater: reRamp(STOCK_RAMPS.atlasWater, seeds.water, CHROMA_CAP),
+    atlasGreen: reRamp(STOCK_RAMPS.atlasGreen, seeds.nature, CHROMA_CAP),
+    swissPaper: reRamp(STOCK_RAMPS.swissPaper, seeds.land, NEUTRAL_CHROMA_CAP),
+    swissWater: reRamp(STOCK_RAMPS.swissWater, seeds.water, CHROMA_CAP),
+    swissGreen: reRamp(STOCK_RAMPS.swissGreen, seeds.nature, CHROMA_CAP),
     ink: reRamp(STOCK_RAMPS.ink, seeds.land, NEUTRAL_CHROMA_CAP),
     paper: reRamp(STOCK_RAMPS.paper, seeds.land, NEUTRAL_CHROMA_CAP),
     graphite: reRamp(STOCK_RAMPS.graphite, seeds.land, MUTED_CHROMA_CAP),
@@ -2881,7 +3041,9 @@ var STYLE_SLOTS = [
   "tropic",
   "sunset",
   "bold",
-  "pastel"
+  "pastel",
+  "atlas",
+  "swiss"
 ];
 var STYLE_BITS = 5n;
 var KIND_BITS = 2n;
@@ -3268,6 +3430,11 @@ export {
   amber,
   applyThemeLayers,
   aqua,
+  atlasGreen,
+  atlasPaper,
+  atlasRelief,
+  atlasRoad,
+  atlasWater,
   azure,
   buildRecipes,
   cobalt,
@@ -3309,6 +3476,11 @@ export {
   seedsFromPalette,
   shuffleSeeds,
   sky,
+  swissGreen,
+  swissPaper,
+  swissRelief,
+  swissRoad,
+  swissWater,
   validateTheme,
   verdant,
   wave