@tileflow/core 0.1.0-alpha.27 → 0.1.0-alpha.29

package/dist/build.js

@@ -1,6 +1,50 @@
 // src/cartography/streets.ts
 import { validateStyleMin } from "@maplibre/maplibre-gl-style-spec";
 
+// src/atmosphere.ts
+var tileflowAtmosphereMetadataKey = "tileflow:atmosphere";
+
+// src/atmosphere-compile.ts
+import { Color } from "@maplibre/maplibre-gl-style-spec";
+var defaults = {
+  skyColor: "#07152b",
+  horizonColor: "#83b9f4",
+  fogColor: "#bad2eb",
+  spaceColor: "#030916",
+  starIntensity: 0.6,
+  starParallax: 0.4
+};
+function resolveTileflowAtmosphere(value) {
+  if (!value) return void 0;
+  const options = { ...defaults, ...value === true ? {} : value };
+  const normalize = (input) => {
+    const color2 = typeof input === "string" ? Color.parse(input) : void 0;
+    if (!color2 || color2.a !== 1)
+      throw new Error("Atmosphere colors must resolve to opaque colors.");
+    return `#${[color2.r, color2.g, color2.b].map(
+      (channel) => Math.round(channel * 255).toString(16).padStart(2, "0")
+    ).join("")}`;
+  };
+  return {
+    ...options,
+    skyColor: normalize(options.skyColor),
+    horizonColor: normalize(options.horizonColor),
+    fogColor: normalize(options.fogColor),
+    spaceColor: normalize(options.spaceColor)
+  };
+}
+function compileTileflowSky(options) {
+  return {
+    "sky-color": options.skyColor,
+    "horizon-color": options.horizonColor,
+    "fog-color": options.fogColor,
+    "sky-horizon-blend": 0.12,
+    "horizon-fog-blend": 0.5,
+    "fog-ground-blend": 0.1,
+    "atmosphere-blend": ["interpolate", ["linear"], ["zoom"], 0, 0.55, 3, 0.45, 5, 0.2, 7, 0]
+  };
+}
+
 // src/data/world-generation.ts
 var tileflowWorldGeneration = "v1";
 
@@ -115,7 +159,7 @@ var canonicalFields = {
   surface: "surface",
   toll: "toll"
 };
-var defaultAttribution = "\xA9 OpenFreeMap, \xA9 OpenMapTiles, \xA9 OpenStreetMap contributors";
+var worldAttribution = '<a href="https://tileflow.dev/copyright">\xA9 Tileflow</a> <a href="https://www.openmaptiles.org/">\xA9 OpenMapTiles</a> <a href="https://www.openstreetmap.org/copyright">\xA9 OpenStreetMap</a>';
 function openMapTiles(options = {}) {
   const layers = { ...canonicalLayers, ...options.layers };
   const fields = { ...canonicalFields, ...options.fields };
@@ -199,7 +243,7 @@ function resolveTileflowData(data, options = {}) {
       );
     }
     return {
-      attribution: defaultAttribution,
+      attribution: worldAttribution,
       generation: descriptor.generation,
       identity: dataIdentity(
         descriptor.type,
@@ -1967,7 +2011,7 @@ function tileflowRoadClassFilter(fields, roadClass) {
 }
 
 // src/modules/roads/index.ts
-var defaults = {
+var defaults2 = {
   detail: "streets",
   disabledClasses: [],
   enabled: true,
@@ -2024,15 +2068,15 @@ function roads(options = {}) {
 }
 function resolveRoads(request) {
   return {
-    detail: request?.detail ?? defaults.detail,
+    detail: request?.detail ?? defaults2.detail,
     disabledClasses: Object.entries(request?.classes ?? {}).filter(([, style]) => style?.enabled === false).map(([roadClass]) => roadClass),
-    enabled: request?.enabled ?? defaults.enabled,
+    enabled: request?.enabled ?? defaults2.enabled,
     explicitClasses: Object.entries(request?.classes ?? {}).filter(([, style]) => style?.enabled !== false).map(([roadClass]) => roadClass),
-    extras: { paths: request?.extras?.paths ?? defaults.extras.paths },
-    hierarchy: request?.hierarchy ?? defaults.hierarchy,
-    oneWayMarkers: request?.oneWayMarkers ?? defaults.oneWayMarkers,
-    outline: request?.outline ?? defaults.outline,
-    weight: request?.weight ?? defaults.weight,
+    extras: { paths: request?.extras?.paths ?? defaults2.extras.paths },
+    hierarchy: request?.hierarchy ?? defaults2.hierarchy,
+    oneWayMarkers: request?.oneWayMarkers ?? defaults2.oneWayMarkers,
+    outline: request?.outline ?? defaults2.outline,
+    weight: request?.weight ?? defaults2.weight,
     ...request?.widthScale ? {
       widthScale: {
         ...defaultRoadWidthScale,
@@ -2073,7 +2117,7 @@ function cloneJson8(value) {
 }
 
 // src/modules/labels/index.ts
-var defaults2 = {
+var defaults3 = {
   aerodromeCodes: "iata",
   collisionPriority: "balanced",
   language: "auto",
@@ -2088,15 +2132,15 @@ function labels(options = {}) {
 }
 function resolveLabels(request) {
   return {
-    aerodromeCodes: request?.aerodromeCodes ?? defaults2.aerodromeCodes,
-    collisionPriority: request?.collisionPriority ?? defaults2.collisionPriority,
-    language: request?.language ?? defaults2.language,
-    junctions: request?.junctions ?? defaults2.junctions,
-    places: request?.places ?? defaults2.places,
+    aerodromeCodes: request?.aerodromeCodes ?? defaults3.aerodromeCodes,
+    collisionPriority: request?.collisionPriority ?? defaults3.collisionPriority,
+    language: request?.language ?? defaults3.language,
+    junctions: request?.junctions ?? defaults3.junctions,
+    places: request?.places ?? defaults3.places,
     ...request?.roadClasses ? { roadClasses: [...request.roadClasses] } : {},
-    roads: request?.roads ?? defaults2.roads,
-    shields: request?.shields ?? defaults2.shields,
-    water: request?.water ?? defaults2.water
+    roads: request?.roads ?? defaults3.roads,
+    shields: request?.shields ?? defaults3.shields,
+    water: request?.water ?? defaults3.water
   };
 }
 function visibleRoadLabelClasses(detail, roads2, explicitClasses) {
@@ -2163,7 +2207,7 @@ function compileLabels(request, roadRequest, context) {
   const { colors } = context;
   const rankField = context.data.schema.fields.rank;
   const capitalField = context.data.schema.fields.capital;
-  const defaults3 = {
+  const defaults4 = {
     places: {
       continent: symbolStyle(context, "places", {
         minZoom: 0,
@@ -2312,7 +2356,7 @@ function compileLabels(request, roadRequest, context) {
     })
   };
   const styles = mergeTileflowDesign(
-    defaults3,
+    defaults4,
     request?.styles
   );
   const result = [];
@@ -3779,7 +3823,7 @@ function compilePoi(request, context, language = "auto") {
     const categoryDensity = requestedCategoryStyle?.density ?? semantics.density;
     const { density: _density, ...categoryStyle } = requestedCategoryStyle ?? {};
     const categoryColor = semantics.color === "category" ? context.colors.poi[category] ?? context.colors.poi.label : context.colors.poi.label;
-    const defaults3 = {
+    const defaults4 = {
       icon: {
         optional: !semantics.placement.coupleIconAndLabel,
         padding: semantics.placement.iconPadding,
@@ -3798,7 +3842,7 @@ function compilePoi(request, context, language = "auto") {
         ]) : 12
       })
     };
-    let style = mergeTileflowDesign(defaults3, categoryStyle);
+    let style = mergeTileflowDesign(defaults4, categoryStyle);
     const markerStyle = style.marker ? resolveMarkerStyle(style) : void 0;
     const showText = semantics.labels && style.text.visible !== false;
     const showIcon = semantics.icons && style.icon.visible !== false;
@@ -4700,12 +4744,12 @@ var ThemeValueResolver = class {
     }
     return result;
   }
-  #resolveTypographyStyle(style, path, defaults3) {
+  #resolveTypographyStyle(style, path, defaults4) {
     const resolved = this.resolveTree(style ?? {}, path);
-    const font = resolved.font ?? defaults3.font;
+    const font = resolved.font ?? defaults4.font;
     if (typeof font !== "string" || !font) throw themeTypeError(`${path}.font`, "font", font);
     assertFontName(font, `${path}.font`);
-    const fallbacks = resolved.fallbacks ?? defaults3.fallbacks;
+    const fallbacks = resolved.fallbacks ?? defaults4.fallbacks;
     if (fallbacks !== void 0 && (!Array.isArray(fallbacks) || fallbacks.some((entry) => typeof entry !== "string" || !entry))) {
       throw themeTypeError(`${path}.fallbacks`, "font array", fallbacks);
     }
@@ -4721,9 +4765,9 @@ var ThemeValueResolver = class {
         seen.add(fallback);
       }
     }
-    const letterSpacing = resolved.letterSpacing ?? defaults3.letterSpacing;
+    const letterSpacing = resolved.letterSpacing ?? defaults4.letterSpacing;
     if (letterSpacing !== void 0) assertFiniteNumber(letterSpacing, `${path}.letterSpacing`);
-    const transform = resolved.transform ?? defaults3.transform;
+    const transform = resolved.transform ?? defaults4.transform;
     if (transform !== void 0 && !["lowercase", "none", "uppercase"].includes(String(transform))) {
       throw themeTypeError(`${path}.transform`, "text transform", transform);
     }
@@ -5254,8 +5298,8 @@ var defaultColors = {
   textMuted: "#727B84",
   textHalo: "#FFFFFF"
 };
-function resolveColors(overrides = {}, defaults3 = defaultColors, moduleOverrides = {}, moduleDefaults = {}) {
-  const defaultInput = defaults3;
+function resolveColors(overrides = {}, defaults4 = defaultColors, moduleOverrides = {}, moduleDefaults = {}) {
+  const defaultInput = defaults4;
   const overrideInput = overrides;
   const defaultModules = moduleDefaults;
   const overrideModules = moduleOverrides;
@@ -5603,32 +5647,32 @@ function textFont(typography, domain) {
   const style = domain ? typography[domain] : typography;
   return [style.font, ...style.fallbacks ?? []];
 }
-function resolveBaseColors(overrides, defaults3) {
-  const background = overrides.background ?? defaults3.background ?? defaultColors.background;
-  const land2 = overrides.land ?? defaults3.land ?? defaultColors.land;
-  const water2 = overrides.water ?? defaults3.water ?? defaultColors.water;
-  const park = overrides.park ?? defaults3.park ?? defaultColors.park;
-  const road = overrides.road ?? defaults3.road ?? defaultColors.road;
-  const text = overrides.text ?? defaults3.text ?? defaultColors.text;
-  const textMuted = overrides.textMuted ?? defaults3.textMuted ?? mix(text, background, 0.42);
-  const textHalo = overrides.textHalo ?? defaults3.textHalo ?? background;
+function resolveBaseColors(overrides, defaults4) {
+  const background = overrides.background ?? defaults4.background ?? defaultColors.background;
+  const land2 = overrides.land ?? defaults4.land ?? defaultColors.land;
+  const water2 = overrides.water ?? defaults4.water ?? defaultColors.water;
+  const park = overrides.park ?? defaults4.park ?? defaultColors.park;
+  const road = overrides.road ?? defaults4.road ?? defaultColors.road;
+  const text = overrides.text ?? defaults4.text ?? defaultColors.text;
+  const textMuted = overrides.textMuted ?? defaults4.textMuted ?? mix(text, background, 0.42);
+  const textHalo = overrides.textHalo ?? defaults4.textHalo ?? background;
   return {
     background,
-    boundary: overrides.boundary ?? defaults3.boundary ?? mix(text, background, 0.72),
-    building: overrides.building ?? defaults3.building ?? mix(land2, text, 0.08),
+    boundary: overrides.boundary ?? defaults4.boundary ?? mix(text, background, 0.72),
+    building: overrides.building ?? defaults4.building ?? mix(land2, text, 0.08),
     land: land2,
     park,
     road,
-    roadMajor: overrides.roadMajor ?? defaults3.roadMajor ?? mix(road, textMuted, 0.16),
+    roadMajor: overrides.roadMajor ?? defaults4.roadMajor ?? mix(road, textMuted, 0.16),
     text,
     textHalo,
     textMuted,
     water: water2
   };
 }
-function resolveGroup(defaults3, themeDefaults, overrides) {
+function resolveGroup(defaults4, themeDefaults, overrides) {
   return {
-    ...defaults3,
+    ...defaults4,
     ...themeDefaults,
     ...overrides
   };
@@ -5752,13 +5796,13 @@ function compileRoads(request, context) {
   const semantics = resolveRoads(request);
   const visible = new Set(visibleRoadClasses(semantics));
   const metrics = roadStyleMetrics(semantics);
-  const defaults3 = defaultClassStyles(context, metrics, semantics);
+  const defaults4 = defaultClassStyles(context, metrics, semantics);
   const contributions = [];
   const { sourceId: source, schema } = context.data;
   for (const [classIndex, roadClass] of roadClassOrder.entries()) {
     if (!visible.has(roadClass) || request?.classes?.[roadClass]?.enabled === false) continue;
     const classConfig = mergeTileflowDesign(
-      defaults3[roadClass],
+      defaults4[roadClass],
       Object.fromEntries(
         ["tunnel", "surface", "bridge"].map((structure) => [
           structure,
@@ -8068,6 +8112,7 @@ function isPlainRecord2(value) {
 }
 
 // src/resolved-map-schema.ts
+import { Color as Color2 } from "@maplibre/maplibre-gl-style-spec";
 import { z as z5 } from "zod";
 
 // src/cartography/data-expression.ts
@@ -11598,6 +11643,24 @@ var terrainSchema = z5.union([
     url: z5.string().trim().min(1).optional()
   }).strict()
 ]);
+var atmosphereColorLiteralSchema = z5.string().refine((value) => Color2.parse(value)?.a === 1, "Expected an opaque color");
+var atmosphereColorSchema = z5.union([
+  atmosphereColorLiteralSchema,
+  fixedStringSchema.extend({ value: atmosphereColorLiteralSchema }),
+  themeTokenReferenceSchema.extend({ category: z5.literal("color") }),
+  themeColorOperationSchema
+]);
+var atmosphereSchema = z5.union([
+  z5.boolean(),
+  z5.object({
+    skyColor: atmosphereColorSchema.optional(),
+    horizonColor: atmosphereColorSchema.optional(),
+    fogColor: atmosphereColorSchema.optional(),
+    spaceColor: atmosphereColorSchema.optional(),
+    starIntensity: z5.number().finite().min(0).max(1).optional(),
+    starParallax: z5.number().finite().min(0).max(1).optional()
+  }).strict()
+]);
 var viewSchema = z5.object({
   bearing: z5.number().finite().min(-180).max(180).optional(),
   center: z5.tuple([z5.number().finite().min(-180).max(180), z5.number().finite().min(-90).max(90)]).optional(),
@@ -11630,6 +11693,7 @@ var themesSchema = z5.record(tileflowThemeNameSchema, tileflowThemeSchema).super
 }).describe("tileflow-themes");
 var systemThemesSchema = z5.object({ dark: tileflowThemeNameSchema, light: tileflowThemeNameSchema }).strict();
 var resolvedTileflowMapSchema = z5.object({
+  atmosphere: atmosphereSchema.optional(),
   data: dataSchema.optional(),
   defaultTheme: tileflowThemeNameSchema,
   fonts: fontDirectoriesSchema.optional(),
@@ -11655,6 +11719,13 @@ var resolvedTileflowMapSchema = z5.object({
       path: ["fonts"]
     });
   }
+  if (map.atmosphere && map.projection !== "globe") {
+    context.addIssue({
+      code: "custom",
+      message: "Atmosphere requires globe projection",
+      path: ["atmosphere"]
+    });
+  }
   if (!Object.hasOwn(map.themes, map.defaultTheme)) {
     context.addIssue({
       code: "custom",
@@ -12095,7 +12166,7 @@ function cloneJson22(value) {
 }
 
 // src/icon-appearance.ts
-import { Color } from "@maplibre/maplibre-gl-style-spec";
+import { Color as Color3 } from "@maplibre/maplibre-gl-style-spec";
 import { z as z7 } from "zod";
 
 // src/icon-layout.ts
@@ -12153,7 +12224,7 @@ function assertTileflowIconLayoutBounds(layout, width, height) {
 }
 
 // src/icon-appearance.ts
-var color = z7.string().max(128).refine((value) => Color.parse(value) !== void 0, "Expected a MapLibre color");
+var color = z7.string().max(128).refine((value) => Color3.parse(value) !== void 0, "Expected a MapLibre color");
 var tileflowIconAppearanceSchema = z7.object({
   representation: z7.literal("sdf"),
   defaults: z7.object({
@@ -13634,7 +13705,9 @@ function compileSemanticStyleInternal(input, options, inspect, onReport) {
       layers
     })
   );
+  const atmosphere = resolveTileflowAtmosphere(config.atmosphere);
   const style = {
+    ...atmosphere ? { sky: compileTileflowSky(atmosphere) } : {},
     version: 8,
     name: config.name ?? "Streets",
     ...glyphs ? { glyphs } : {},
@@ -13652,6 +13725,7 @@ function compileSemanticStyleInternal(input, options, inspect, onReport) {
         "tileflow:compilerVersion": tileflowSemanticCompilerIdentity.version,
         ...mapMetadata.lineage && mapMetadata.lineage.length > 1 ? { "tileflow:extends": mapMetadata.lineage.slice(1) } : {}
       } : {},
+      ...atmosphere ? { [tileflowAtmosphereMetadataKey]: { version: 1, ...atmosphere } } : {},
       "tileflow:theme": selected.name,
       "tileflow:colorScheme": resolvedTheme.colorScheme,
       "tileflow:data": data.identity,
@@ -14341,6 +14415,7 @@ var TileflowMapResolutionError = class extends Error {
   }
 };
 var tileflowMapMergeStrategies = {
+  atmosphere: "atomic",
   data: "atomic",
   defaultTheme: "atomic",
   extends: "lineage",
@@ -14994,7 +15069,11 @@ var tileflowRenderedIconIdentitySchema = z10.object({
   }).strict()
 }).strict();
 var tileflowIconCompositionSchema = z10.object({
-  format: z10.enum(["tileflow-icon-composition-v1", "tileflow-icon-composition-v2"]),
+  // An explicit map keeps declaration order independent of TypeScript's literal cache.
+  format: z10.enum({
+    "tileflow-icon-composition-v1": "tileflow-icon-composition-v1",
+    "tileflow-icon-composition-v2": "tileflow-icon-composition-v2"
+  }),
   compositionVersion: z10.union([z10.literal(1), z10.literal(2)]),
   packageHash: tileflowIconPackageContentHashSchema,
   contributors: z10.array(