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

package/dist/index.js

@@ -1664,12 +1664,12 @@ var init_model = __esm({
         }
         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);
         }
@@ -1685,9 +1685,9 @@ var init_model = __esm({
             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);
         }
@@ -2319,6 +2319,50 @@ function asRecord(value) {
 // 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 color3 = typeof input === "string" ? Color.parse(input) : void 0;
+    if (!color3 || color3.a !== 1)
+      throw new Error("Atmosphere colors must resolve to opaque colors.");
+    return `#${[color3.r, color3.g, color3.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";
 var tileflowWorldTileJsonUrl = "https://api.tileflow.dev/tiles/world/tiles.json";
@@ -2434,7 +2478,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 };
@@ -2758,7 +2802,7 @@ function resolveTileflowData(data, options = {}) {
       );
     }
     return {
-      attribution: defaultAttribution,
+      attribution: worldAttribution,
       generation: descriptor.generation,
       identity: dataIdentity(
         descriptor.type,
@@ -4340,7 +4384,7 @@ function tileflowRoadClassFilter(fields, roadClass) {
 }
 
 // src/modules/roads/index.ts
-var defaults = {
+var defaults2 = {
   detail: "streets",
   disabledClasses: [],
   enabled: true,
@@ -4397,15 +4441,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,
@@ -4446,7 +4490,7 @@ function cloneJson8(value) {
 }
 
 // src/modules/labels/index.ts
-var defaults2 = {
+var defaults3 = {
   aerodromeCodes: "iata",
   collisionPriority: "balanced",
   language: "auto",
@@ -4461,15 +4505,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) {
@@ -4538,7 +4582,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,
@@ -4687,7 +4731,7 @@ function compileLabels(request, roadRequest, context) {
     })
   };
   const styles = mergeTileflowDesign(
-    defaults3,
+    defaults4,
     request?.styles
   );
   const result = [];
@@ -6158,7 +6202,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,
@@ -6177,7 +6221,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;
@@ -6380,8 +6424,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;
@@ -6729,32 +6773,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
   };
@@ -6878,13 +6922,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,
@@ -9184,6 +9228,7 @@ function isPlainRecord2(value) {
 }
 
 // src/resolved-map-schema.ts
+import { Color as Color2 } from "@maplibre/maplibre-gl-style-spec";
 import { z as z6 } from "zod";
 
 // src/cartography/data-expression.ts
@@ -12801,6 +12846,24 @@ var terrainSchema = z6.union([
     url: z6.string().trim().min(1).optional()
   }).strict()
 ]);
+var atmosphereColorLiteralSchema = z6.string().refine((value) => Color2.parse(value)?.a === 1, "Expected an opaque color");
+var atmosphereColorSchema = z6.union([
+  atmosphereColorLiteralSchema,
+  fixedStringSchema.extend({ value: atmosphereColorLiteralSchema }),
+  themeTokenReferenceSchema.extend({ category: z6.literal("color") }),
+  themeColorOperationSchema
+]);
+var atmosphereSchema = z6.union([
+  z6.boolean(),
+  z6.object({
+    skyColor: atmosphereColorSchema.optional(),
+    horizonColor: atmosphereColorSchema.optional(),
+    fogColor: atmosphereColorSchema.optional(),
+    spaceColor: atmosphereColorSchema.optional(),
+    starIntensity: z6.number().finite().min(0).max(1).optional(),
+    starParallax: z6.number().finite().min(0).max(1).optional()
+  }).strict()
+]);
 var viewSchema = z6.object({
   bearing: z6.number().finite().min(-180).max(180).optional(),
   center: z6.tuple([z6.number().finite().min(-180).max(180), z6.number().finite().min(-90).max(90)]).optional(),
@@ -12833,6 +12896,7 @@ var themesSchema = z6.record(tileflowThemeNameSchema, tileflowThemeSchema).super
 }).describe("tileflow-themes");
 var systemThemesSchema = z6.object({ dark: tileflowThemeNameSchema, light: tileflowThemeNameSchema }).strict();
 var resolvedTileflowMapSchema = z6.object({
+  atmosphere: atmosphereSchema.optional(),
   data: dataSchema.optional(),
   defaultTheme: tileflowThemeNameSchema,
   fonts: fontDirectoriesSchema.optional(),
@@ -12858,6 +12922,13 @@ var resolvedTileflowMapSchema = z6.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",
@@ -13272,7 +13343,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 z8 } from "zod";
 
 // src/icon-layout.ts
@@ -13346,7 +13417,7 @@ function scaleTileflowIconLayout(layout, scale) {
 }
 
 // src/icon-appearance.ts
-var color2 = z8.string().max(128).refine((value) => Color.parse(value) !== void 0, "Expected a MapLibre color");
+var color2 = z8.string().max(128).refine((value) => Color3.parse(value) !== void 0, "Expected a MapLibre color");
 var tileflowIconAppearanceSchema = z8.object({
   representation: z8.literal("sdf"),
   defaults: z8.object({
@@ -14888,7 +14959,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 } : {},
@@ -14906,6 +14979,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,
@@ -15232,6 +15306,7 @@ var TileflowMapResolutionError = class extends Error {
   }
 };
 var tileflowMapMergeStrategies = {
+  atmosphere: "atomic",
   data: "atomic",
   defaultTheme: "atomic",
   extends: "lineage",
@@ -15727,12 +15802,12 @@ function validateTileflowMap(input) {
 }
 
 // src/icon-preview.ts
-import { Color as Color2 } from "@maplibre/maplibre-gl-style-spec";
+import { Color as Color4 } from "@maplibre/maplibre-gl-style-spec";
 function resolveTileflowIconPreviewPaint(appearance) {
   return {
     ...appearance.defaults,
-    color: Color2.parse(appearance.defaults.color),
-    haloColor: Color2.parse(appearance.defaults.haloColor)
+    color: Color4.parse(appearance.defaults.color),
+    haloColor: Color4.parse(appearance.defaults.haloColor)
   };
 }
 function createTileflowIconPreviewRuntime() {
@@ -17894,7 +17969,11 @@ var tileflowRenderedIconIdentitySchema = z12.object({
   }).strict()
 }).strict();
 var tileflowIconCompositionSchema = z12.object({
-  format: z12.enum(["tileflow-icon-composition-v1", "tileflow-icon-composition-v2"]),
+  // An explicit map keeps declaration order independent of TypeScript's literal cache.
+  format: z12.enum({
+    "tileflow-icon-composition-v1": "tileflow-icon-composition-v1",
+    "tileflow-icon-composition-v2": "tileflow-icon-composition-v2"
+  }),
   compositionVersion: z12.union([z12.literal(1), z12.literal(2)]),
   packageHash: tileflowIconPackageContentHashSchema,
   contributors: z12.array(

package/dist/{manifest-types-BdGjIYy-.d.ts → manifest-types-BZU4zbmI.d.ts}

@@ -514,6 +514,7 @@ type TileflowLight = {
     position?: readonly [number, number, number];
 };
 type MapLibreStyle = {
+    sky?: Record<string, unknown>;
     version: 8;
     name: string;
     glyphs?: string;

package/dist/manifest.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { T as TileflowRuntimeManifest } from './manifest-types-BdGjIYy-.js';
-export { a as TileflowRuntimeColorScheme, b as TileflowRuntimeManifestMapEntry, c as TileflowRuntimeManifestTheme, d as TileflowRuntimeSystemThemes, t as tileflowRuntimeManifestLimits, e as tileflowRuntimeManifestVersion } from './manifest-types-BdGjIYy-.js';
+import { T as TileflowRuntimeManifest } from './manifest-types-BZU4zbmI.js';
+export { a as TileflowRuntimeColorScheme, b as TileflowRuntimeManifestMapEntry, c as TileflowRuntimeManifestTheme, d as TileflowRuntimeSystemThemes, t as tileflowRuntimeManifestLimits, e as tileflowRuntimeManifestVersion } from './manifest-types-BZU4zbmI.js';
 
 declare const tileflowRuntimeManifestSchema: z.ZodType<TileflowRuntimeManifest>;
 declare function parseTileflowRuntimeManifest(input: unknown): TileflowRuntimeManifest;

package/dist/native-profile.d.ts

@@ -34,6 +34,7 @@ type TileflowLight = {
     position?: readonly [number, number, number];
 };
 type MapLibreStyle = {
+    sky?: Record<string, unknown>;
     version: 8;
     name: string;
     glyphs?: string;

package/dist/runtime.d.ts

@@ -1 +1 @@
-export { z as TileflowAnalytics, $ as TileflowManifestFetchOptions, a0 as TileflowManifestLoadOptions, a1 as TileflowMapMode, a2 as TileflowMapModeOptions, ae as TileflowResolvedRuntimeTheme, aB as TileflowRuntimeCenterLike, a as TileflowRuntimeColorScheme, T as TileflowRuntimeManifest, aC as TileflowRuntimeManifestMap, b as TileflowRuntimeManifestMapEntry, c as TileflowRuntimeManifestTheme, aD as TileflowRuntimeSource, aE as TileflowRuntimeSourceValidation, aF as TileflowRuntimeStyle, aG as TileflowRuntimeStyleOptions, d as TileflowRuntimeSystemThemes, aH as TileflowRuntimeViewOptions, aI as TileflowSessionController, aJ as TileflowSessionGrantResponse, aM as TileflowStyleFontFace, b9 as TileflowThemeSelection, bh as assertValidTileflowRuntimeSource, bi as clearTileflowManifestCache, bk as createTileflowSessionController, bl as createTileflowSessionId, bm as defaultTileflowManifestUrl, bn as defaultTileflowRuntimeView, bp as getTileflowAnalyticsApiUrl, bq as getTileflowStyleFontFaces, br as inferTileflowAnalyticsFromStyleUrl, bs as loadTileflowManifest, bt as mergeTileflowAnalytics, bu as normalizeTileflowRuntimeCenter, bv as normalizeTileflowStaticImageSize, bQ as normalizeTileflowSurfaceId, bw as normalizeTileflowUrl, bx as resolveTileflowAnalyticsRequestUrl, by as resolveTileflowManifestMap, bz as resolveTileflowMapMode, bA as resolveTileflowRuntimeStyle, bB as resolveTileflowRuntimeTheme, bC as resolveTileflowRuntimeView, bD as resolveTileflowStaticImageUrl, bE as shouldLoadTileflowManifest, bF as startTileflowSession, bH as tileflowStyleFontFaceLimits, bI as tileflowStyleFontFacesMetadataKey, bL as validateTileflowRuntimeSource, bM as validateTileflowThemeSelection } from './manifest-types-BdGjIYy-.js';
+export { z as TileflowAnalytics, $ as TileflowManifestFetchOptions, a0 as TileflowManifestLoadOptions, a1 as TileflowMapMode, a2 as TileflowMapModeOptions, ae as TileflowResolvedRuntimeTheme, aB as TileflowRuntimeCenterLike, a as TileflowRuntimeColorScheme, T as TileflowRuntimeManifest, aC as TileflowRuntimeManifestMap, b as TileflowRuntimeManifestMapEntry, c as TileflowRuntimeManifestTheme, aD as TileflowRuntimeSource, aE as TileflowRuntimeSourceValidation, aF as TileflowRuntimeStyle, aG as TileflowRuntimeStyleOptions, d as TileflowRuntimeSystemThemes, aH as TileflowRuntimeViewOptions, aI as TileflowSessionController, aJ as TileflowSessionGrantResponse, aM as TileflowStyleFontFace, b9 as TileflowThemeSelection, bh as assertValidTileflowRuntimeSource, bi as clearTileflowManifestCache, bk as createTileflowSessionController, bl as createTileflowSessionId, bm as defaultTileflowManifestUrl, bn as defaultTileflowRuntimeView, bp as getTileflowAnalyticsApiUrl, bq as getTileflowStyleFontFaces, br as inferTileflowAnalyticsFromStyleUrl, bs as loadTileflowManifest, bt as mergeTileflowAnalytics, bu as normalizeTileflowRuntimeCenter, bv as normalizeTileflowStaticImageSize, bQ as normalizeTileflowSurfaceId, bw as normalizeTileflowUrl, bx as resolveTileflowAnalyticsRequestUrl, by as resolveTileflowManifestMap, bz as resolveTileflowMapMode, bA as resolveTileflowRuntimeStyle, bB as resolveTileflowRuntimeTheme, bC as resolveTileflowRuntimeView, bD as resolveTileflowStaticImageUrl, bE as shouldLoadTileflowManifest, bF as startTileflowSession, bH as tileflowStyleFontFaceLimits, bI as tileflowStyleFontFacesMetadataKey, bL as validateTileflowRuntimeSource, bM as validateTileflowThemeSelection } from './manifest-types-BZU4zbmI.js';

package/docs/authoring-model.md

@@ -125,8 +125,8 @@ export default defineMap({
 
 The standalone map above is complete as written. A map always owns its complete text provider; Core does not
 obtain fonts or sprites from World and never invents a fallback URL. The URL-backed first-party
-`streets`, `ferraris`, `harad`, `soundings`, `verdant`, and `sanFrancisto` maps declare their glyph
-providers directly. `baedeker`, `civica`, `cyberpunk`, `matrix`, `siegfried`, and `superTileWorld`
+`streets`, `ferraris`, `harad`, `soundings`, and `blueprint` maps declare their glyph
+providers directly. `baedeker`, `civica`, and `siegfried`
 declare packaged fonts, so ordinary imports and derived maps compile without out-of-band release
 metadata.
 

package/docs/data-is-separate-from-design.md

@@ -120,7 +120,7 @@ another. Browser adapters load local faces before MapLibre. Native releases use
 `glyphs` URL provider instead, which enumerates the exact comma-joined MapLibre request keys in
 `fontStacks`.
 
-Streets, Ferraris, Härad, Soundings, Verdant, and San Francisto each declare
+Streets, Ferraris, Härad, Soundings, and Blueprint each declare
 `https://api.tileflow.dev/base/33d4de5e8086d9d629d67d3f39fedb87e23686c4c1ac653c27e2a52aee9d00b3/glyphs/{fontstack}/{range}.pbf`
 with the exact `Noto Sans Regular` and `Noto Sans Bold` stacks. The full hash identifies one
 published, immutable glyph collection independent of World data. The older `/fonts/...` endpoint
@@ -332,8 +332,7 @@ source classes into one civic color.
 
 World and text assets are independent contracts. `tileflowWorld()` selects `world-v1/current` or an
 exact `releaseId + descriptorSha256`; a `glyphs` declaration contains its own complete URL. Ordinary
-imports of Streets, Baedeker, Cívica, Ferraris, Härad, Siegfried, Soundings, Cyberpunk, Matrix, Verdant,
-San Francisto, and Super Tile World
+imports of Streets, Baedeker, Cívica, Ferraris, Härad, Siegfried, Soundings, Cyberpunk, Matrix, Blueprint, and Super Tile World
 remain usable because each official map owns or inherits a URL or packaged-font provider.
 URL-backed maps become exact-byte reproducible
 when the immutable global base-asset set is published and their explicit URL is updated to its

package/docs/globe-atmosphere.md

@@ -0,0 +1,83 @@
+# Globe atmosphere
+
+Enable atmosphere in the map exported by `tileflow.config.ts`. Install `@tileflow/core` and
+`@tileflow/maps` and use a browser adapter from the same compatible SDK release. The example
+extends the complete Streets map, including its data and text resources.
+
+<!-- docs:check -->
+
+```ts
+import {defineMap} from '@tileflow/core';
+import {streets} from '@tileflow/maps';
+
+export default defineMap({
+  id: 'earth',
+  version: 1,
+  extends: streets,
+  projection: 'globe',
+  atmosphere: true,
+  view: {center: [2.3522, 48.8566], zoom: 2},
+});
+```
+
+The result has a blue atmospheric rim, a dark space background, and a deterministic star field.
+Stars move slightly with the camera. There is no continuous animation while the camera is still.
+The space background, stars, and supplementary rim fade between zooms 3 and 6; native atmospheric
+scattering fades out by zoom 7. Coordinates are longitude, then latitude.
+
+Omit `atmosphere` to inherit it from the base map. A map without inherited atmosphere remains
+unchanged. Set `atmosphere: false` to disable an inherited atmosphere. An enabled atmosphere requires
+`projection: 'globe'`; validation rejects a Mercator or unspecified projection. Atmosphere options
+replace the inherited object atomically rather than merging individual fields.
+
+## Configure appearance
+
+Use an object instead of `true` to override defaults:
+
+| Option          | Default   | Meaning                                                 |
+| --------------- | --------- | ------------------------------------------------------- |
+| `skyColor`      | `#07152b` | Near-space sky color                                    |
+| `horizonColor`  | `#83b9f4` | Horizon and supplementary rim color                     |
+| `fogColor`      | `#bad2eb` | Native atmospheric fog color                            |
+| `spaceColor`    | `#030916` | Outer space background color                            |
+| `starIntensity` | `0.6`     | Brightness from 0 to 1; 0 hides stars                   |
+| `starParallax`  | `0.4`     | Camera-relative motion from 0 to 1; 0 keeps stars still |
+
+Colors follow the usual theme contract: use `token.color(...)`, color operations, or
+`fixed(color, {reason})`. They must resolve to opaque colors. Compilation normalizes them to
+six-digit hexadecimal values in the runtime metadata. Numeric options must be finite and within
+0–1. Unknown properties are rejected. For example, this fragment belongs inside `defineMap(...)`
+and uses `fixed` imported from `@tileflow/core`:
+
+```ts
+atmosphere: {
+  horizonColor: fixed('#83b9f4', {reason: 'Earth atmosphere stays blue across map themes'}),
+  starIntensity: 0.5,
+  starParallax: 0.25,
+},
+```
+
+The browser's reduced-motion preference overrides parallax while keeping the sky and stars visible.
+No additional image, font, API key, or network request is needed for the effect.
+
+## Browser integration
+
+The compiler emits MapLibre `sky` and versioned `metadata['tileflow:atmosphere']` in every concrete
+style. React, Vue, Svelte, and standalone browser capture attach the shared atmosphere runtime.
+Theme changes update the effect from the newly loaded style. Loading a style without atmosphere
+removes the decoration.
+
+When constructing a MapLibre map directly, call `attachTileflowAtmosphere(map)` from
+`@tileflow/core/browser` after constructing the map. Keep its returned cleanup function and call it
+before removing the map; the map's `remove` event also disposes it. The helper creates its own
+noninteractive, accessibility-hidden canvas inside the map container. It does not create a map,
+change the camera, or add controls. Preserve the renderer's transparent canvas and standard
+MapLibre CSS so space can show around the globe.
+
+Importing the browser entry is safe during server rendering. Call the attachment only in the
+browser, after mounting. Raw MapLibre consumers that do not attach the helper display the compiled
+native atmosphere but do not receive Tileflow's stars or space background.
+
+The native artifact profile does not support globe atmosphere and rejects `sky`. This browser
+capability does not establish React Native or hosted Static Maps support. Public availability is
+established by the installed package version, not by this repository's main branch.

package/docs/hosted-session-authorization.md

@@ -48,21 +48,15 @@ import {
   baedeker,
   baedekerFonts,
   baedekerIcons,
+  blueprint,
+  blueprintIcons,
   civica,
   civicaFonts,
   civicaIcons,
-  cyberpunk,
-  cyberpunkFonts,
-  cyberpunkIcons,
   ferraris,
   ferrarisIcons,
   harad,
   haradIcons,
-  matrix,
-  matrixFonts,
-  matrixIcons,
-  sanFrancisto,
-  sanFrancistoIcons,
   siegfried,
   siegfriedFonts,
   siegfriedIcons,
@@ -71,11 +65,6 @@ import {
   streets,
   streetsIcons,
   streetsThemes,
-  superTileWorld,
-  superTileWorldFonts,
-  superTileWorldIcons,
-  verdant,
-  verdantIcons,
 } from '@tileflow/maps';
 ```
 
@@ -87,11 +76,8 @@ without changing the asset collection. Baedeker declares `[baedekerIcons]`, whos
 patterns support its travel-atlas design, and `[baedekerFonts]`, its own Cormorant Garamond
 directory; it derives contours in the browser from unpackaged Mapterhorn terrain tiles. Cívica
 declares `[civicaIcons]` for its original civic-print patterns and destination artwork and
-`[civicaFonts]` for its packaged lettering. Super Tile World declares `[superTileWorldIcons]` and
-`[superTileWorldFonts]` for its pixel-art sprites, patterns, and lettering. Cyberpunk
-declares `[cyberpunkIcons]` and `[cyberpunkFonts]`; Matrix
-independently declares `[matrixIcons]` and `[matrixFonts]`. San Francisto declares
-`[sanFrancistoIcons]` for its four technical hatches and schematic POI node, derives contours from
+`[civicaFonts]` for its packaged lettering. Blueprint declares
+`[blueprintIcons]` for its four technical hatches and schematic POI node, derives contours from
 unpackaged Mapterhorn tiles, and uses the canonical Noto Sans glyph provider. The same asset
 operation is available to applications:
 
@@ -117,6 +103,6 @@ explicit locked descriptor, not a generic source registry.
 and prepares ordinary public artifacts without serializing installation paths. It compiles one
 deterministic sprite from the final icon composition and validates every literal `icon-image`,
 `fill-pattern`, and `line-pattern` in the final style against it. It also prepares any declared font
-directories generically; `baedekerFonts`, `cyberpunkFonts`, `matrixFonts`, and `siegfriedFonts` are
+directories generically; `baedekerFonts`, `civicaFonts`, and `siegfriedFonts` are
 ordinary package descriptors rather than pipeline special cases. Calling the pure compiler for a map whose style needs unprepared
 assets fails instead of emitting broken runtime references.

package/docs/public-api-and-browser-subpath.md

@@ -76,6 +76,7 @@ Framework adapters import the browser-only lifecycle kernel explicitly:
 
 ```ts
 import {
+  attachTileflowAtmosphere,
   attachTileflowFairUseNotice,
   attachTileflowMapLifecycle,
   createTileflowSessionStarter,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tileflow/core",
-  "version": "0.1.0-alpha.27",
+  "version": "0.1.0-alpha.29",
   "license": "Apache-2.0",
   "description": "Typed Tileflow config and MapLibre style compiler.",
   "type": "module",