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

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.28",
+  "version": "0.1.0-alpha.29",
   "license": "Apache-2.0",
   "description": "Typed Tileflow config and MapLibre style compiler.",
   "type": "module",