@unmap/themes 0.8.0 → 0.9.1

package/dist/index.d.ts

@@ -850,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, 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, 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 };

package/dist/index.js

@@ -2139,14 +2139,13 @@ function buildRecipes(r) {
   };
   const PASTEL_DARK = {
     background: r.lilac[1e3],
-    // Shares `orchid`'s ground, and cannot stop sharing it by moving a step. lilac[950] is the
-    // only free one and it sits within 1.01:1 of this style's navy water, which erases the
-    // coastline (the gateway's cartography suite holds land against water at 1.08). Every other
-    // ramp either lands on another style's earth (indigo[900] is `sunset`'s), merges with this
-    // style's own scrub, or is the wrong hue for a lavender map. Separating these two needs a
-    // decision about pastel's water or its ramp, not a step move.
-    earth: r.lilac[900],
-    water: r.cobalt[950],
+    earth: r.lilac[950],
+    // Water lighter than land, which `blueprint`, `tropic` and `bold` already do: the three
+    // styles whose water is the thing you remember about them. This one's is periwinkle, and at
+    // cobalt[950] the dark half had turned it near-black, so the name stopped being true after
+    // sundown. Lifting it also unpins the ground, which had to sit at `orchid`'s lilac[900]
+    // because the only free step below was within 1.01:1 of that near-black water.
+    water: r.cobalt[800],
     parkA: r.jade[850],
     parkB: r.jade[800],
     woodA: r.fern[800],
@@ -2183,18 +2182,18 @@ function buildRecipes(r) {
     bridgeCasing: r.lilac[1e3],
     labels: {
       city: r.lilac[25],
-      cityHalo: r.lilac[900],
+      cityHalo: r.lilac[950],
       state: r.lilac[300],
-      stateHalo: r.lilac[900],
+      stateHalo: r.lilac[950],
       country: r.lilac[300],
       subplace: r.lilac[300],
-      subplaceHalo: r.lilac[900],
+      subplaceHalo: r.lilac[950],
       address: r.lilac[400],
-      addressHalo: r.lilac[900],
+      addressHalo: r.lilac[950],
       roadMinor: r.lilac[400],
-      roadMinorHalo: r.lilac[900],
+      roadMinorHalo: r.lilac[950],
       roadMajor: r.lilac[100],
-      roadMajorHalo: r.lilac[900],
+      roadMajorHalo: r.lilac[950],
       ocean: r.cobalt[400]
     },
     pois: {
@@ -3165,6 +3164,77 @@ async function decodeDeflate(code) {
   }
   return validateTheme(parsed);
 }
+
+// src/seeds-from-palette.ts
+var CHROMATIC_FLOOR = 0.04;
+var HUE_DEDUP = 20;
+var WATER_HUE = { lo: 190, hi: 270 };
+var NATURE_HUE = { lo: 100, hi: 170 };
+var DISPLAY_L = { lo: 0.35, hi: 0.7 };
+var wrapHue = (h) => (h % 360 + 360) % 360;
+var hueDelta = (a, b) => {
+  const d = Math.abs(wrapHue(a) - wrapHue(b));
+  return Math.min(d, 360 - d);
+};
+var inBand = (h, band) => {
+  const hue = wrapHue(h);
+  return hue >= band.lo && hue <= band.hi;
+};
+var normalizeHex = (hex) => {
+  const raw = hex.startsWith("#") ? hex.slice(1) : hex;
+  return `#${raw.slice(0, 6).toUpperCase()}`;
+};
+var parse = (color) => {
+  if (!/^#?[0-9a-fA-F]{6}/.test(color.hex)) return null;
+  const hex = normalizeHex(color.hex);
+  const { l, c, h } = hexToOklch(hex);
+  if (!Number.isFinite(l) || !Number.isFinite(c) || !Number.isFinite(h)) return null;
+  return { hex, proportion: Math.max(color.proportion, 0), l, c, h, score: 0 };
+};
+var displaySeed = (color) => oklchToHex({
+  l: Math.min(DISPLAY_L.hi, Math.max(DISPLAY_L.lo, color.l)),
+  c: color.c,
+  h: color.h
+});
+var byScore = (a, b) => b.score - a.score || b.proportion - a.proportion || a.hex.localeCompare(b.hex);
+var distinctHues = (ranked) => {
+  const out = [];
+  for (const color of ranked) {
+    if (out.some((kept) => hueDelta(kept.h, color.h) < HUE_DEDUP)) continue;
+    out.push(color);
+  }
+  return out;
+};
+var pickInBand = (candidates, band) => candidates.find((color) => inBand(color.h, band));
+function fromNeutrals(neutrals) {
+  const mid = neutrals.slice().sort((a, b) => Math.abs(a.l - 0.5) - Math.abs(b.l - 0.5))[0] ?? parse({ hex: "#808080", proportion: 1 });
+  const grey = displaySeed(mid);
+  return { land: grey, water: grey, nature: grey, accent: DEFAULT_SEEDS.accent };
+}
+function seedsFromPalette(colors) {
+  const parsed = colors.map(parse).filter((c) => c !== null);
+  if (parsed.length === 0) return { ...DEFAULT_SEEDS };
+  const chromatic = parsed.filter((c) => c.c >= CHROMATIC_FLOOR);
+  if (chromatic.length === 0) return fromNeutrals(parsed);
+  const total = chromatic.reduce((sum, c) => sum + c.proportion, 0) || 1;
+  for (const color of chromatic) {
+    color.score = 0.7 * (color.proportion / total) + 0.3 * Math.min(color.c / 0.15, 1);
+  }
+  const ranked = chromatic.slice().sort(byScore);
+  const distinct = distinctHues(ranked);
+  const land = distinct[0];
+  const rest = distinct.slice(1);
+  const water = pickInBand(rest, WATER_HUE) ?? rest[0] ?? land;
+  const afterWater = distinct.filter((c) => c !== land && c !== water);
+  const nature = pickInBand(afterWater, NATURE_HUE) ?? afterWater[0] ?? land;
+  const accent = ranked.slice().sort((a, b) => b.c - a.c || byScore(a, b))[0];
+  return {
+    land: displaySeed(land),
+    water: displaySeed(water),
+    nature: displaySeed(nature),
+    accent: accent.hex
+  };
+}
 export {
   BUILDINGS_3D_LAYER_ID,
   DEFAULT_LAYER_VISIBILITY,
@@ -3225,6 +3295,7 @@ export {
   resolveTheme,
   rose,
   sandstone,
+  seedsFromPalette,
   shuffleSeeds,
   sky,
   validateTheme,