@tileflow/core 0.1.0-alpha.19 → 0.1.0-alpha.20

package/README.md

@@ -247,6 +247,18 @@ source-layers or properties while preserving the versioned semantic contract. Ex
 credentials do not belong in public Style JSON; supply them through the framework's
 `transformRequest` integration.
 
+Tileflow's OpenMapTiles contract also recognizes the optional `globallandcover` extension. The
+default Streets style maps its `barren`, `crop`, `grass`, `shrub`, `snow`, `trees`, and `urban`
+classes beneath the OSM land layers at zooms 0–7, fading to transparent at zoom 8. Sources with a
+different layer name can use `openMapTiles({layers: {globalLandcover: 'my_landcover'}})`; archives
+without the extension remain compatible and simply render no features for that style layer.
+
+The pinned legacy Tileflow World revision keeps its historical attribution inline in the generated
+style. Every other explicitly pinned official revision delegates attribution to its versioned
+TileJSON, so MapLibre displays the exact text bound to that archive's release receipt. The SDK does
+not guess a legal string or fall back to the legacy attribution for a new product; publishing must
+fail before selection when that immutable TileJSON has no receipt-backed attribution.
+
 ## Capture scenes
 
 Commit named scenes beside maps. Scenes affect visual evidence, not style or manifest identity.

package/dist/browser.d.ts

@@ -1,4 +1,4 @@
-import { T as TileflowAnalytics, a as TileflowSessionController } from './runtime-Dd_xGAXq.js';
+import { T as TileflowAnalytics, a as TileflowSessionController } from './runtime-DroKDIuB.js';
 import 'zod';
 
 type TileflowMapReadinessState = 'error' | 'idle' | 'loading';

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { b as TileflowBaseColors, c as TileflowConfig, d as TileflowProjectConfig, V as ValidationResult, e as TileflowRoadsModuleOptions, f as TileflowRoadsModuleConfig, g as TileflowLabelsModuleOptions, h as TileflowLabelsModuleConfig, i as TileflowPoiModuleOptions, j as TileflowPoiModuleConfig } from './runtime-Dd_xGAXq.js';
-export { M as MapLibreSprite, k as MapLibreStyle, N as NormalizedTileflowCaptureScene, O as OpenMapTilesFieldBindings, l as OpenMapTilesLayerBindings, m as OpenMapTilesSchema, n as OpenMapTilesSchemaOptions, R as ResolvedTileflowData, o as ResolvedTileflowTypography, p as TileflowAerowaysModuleConfig, q as TileflowAerowaysModuleOptions, r as TileflowAlignment, T as TileflowAnalytics, s as TileflowAreaStyle, t as TileflowBackgroundPaint, u as TileflowBackgroundStyle, v as TileflowBoundariesModuleConfig, w as TileflowBoundariesModuleOptions, x as TileflowBoundaryColorConfig, y as TileflowBuildingColorConfig, z as TileflowBuildingMode, A as TileflowBuildingsModuleConfig, B as TileflowBuildingsModuleOptions, C as TileflowCaptureApplicationTarget, D as TileflowCaptureBoundsCamera, E as TileflowCaptureCamera, F as TileflowCaptureCenterCamera, G as TileflowCaptureMapTarget, H as TileflowCaptureScene, I as TileflowCaptureTarget, J as TileflowCaptureViewport, K as TileflowCirclePaint, L as TileflowCircleStyle, P as TileflowColor, Q as TileflowColorConfig, S as TileflowColors, U as TileflowDataConfig, W as TileflowDataIdentity, X as TileflowExpression, Y as TileflowExtrusionPaint, Z as TileflowExtrusionStyle, _ as TileflowFillPaint, $ as TileflowFillStyle, a0 as TileflowFilterExpression, a1 as TileflowFontWeight, a2 as TileflowHostedNotoSansWeight, a3 as TileflowHydroColorConfig, a4 as TileflowIconAnchor, a5 as TileflowIconLayout, a6 as TileflowIconPaint, a7 as TileflowIconSet, a8 as TileflowIconSetConfig, a9 as TileflowIconStyle, aa as TileflowLabelColorConfig, ab as TileflowLabelDetail, ac as TileflowLabelLanguage, ad as TileflowLabelStyles, ae as TileflowLandModuleConfig, af as TileflowLandModuleOptions, ag as TileflowLandcoverClass, ah as TileflowLandcoverColorConfig, ai as TileflowLanduseClass, aj as TileflowLanduseColorConfig, ak as TileflowLayerPlacement, al as TileflowLayerRange, am as TileflowLineCap, an as TileflowLineHatchStyle, ao as TileflowLineJoin, ap as TileflowLineLayout, aq as TileflowLinePaint, ar as TileflowLineStackStyle, as as TileflowLineStyle, at as TileflowManifest, au as TileflowManifestLoadOptions, av as TileflowMapConfig, aw as TileflowMapMarker, ax as TileflowMapMode, ay as TileflowMapModeOptions, az as TileflowMountainBikeScale, aA as TileflowPlaceLabelClass, aB as TileflowPoi, aC as TileflowPoiCategory, aD as TileflowPoiCategoryStyle, aE as TileflowPoiClassMapping, aF as TileflowPoiColorConfig, aG as TileflowPoiColorMode, aH as TileflowPoiDensity, aI as TileflowPoiIcons, aJ as TileflowPoiLabels, aK as TileflowProjectIconSets, aL as TileflowProjectThemes, aM as TileflowRawOverride, aN as TileflowRoadAreaStyle, aO as TileflowRoadClass, aP as TileflowRoadClassStyle, aQ as TileflowRoadColorConfig, aR as TileflowRoadDetail, aS as TileflowRoadExtras, aT as TileflowRoadHierarchy, aU as TileflowRoadLabelDetail, aV as TileflowRoadLayerStyle, aW as TileflowRoadModifier, aX as TileflowRoadOutline, aY as TileflowRoadRestriction, aZ as TileflowRoadServiceType, a_ as TileflowRoadShieldDetail, a$ as TileflowRoadShieldStyles, b0 as TileflowRoadStructure, b1 as TileflowRoadTreatmentLayerStyle, b2 as TileflowRoadTreatmentLineStyle, b3 as TileflowRoadTreatmentStyle, b4 as TileflowRoadWeight, b5 as TileflowRuntimeManifest, b6 as TileflowRuntimeManifestMap, b7 as TileflowRuntimeManifestMapEntry, b8 as TileflowRuntimeStyle, b9 as TileflowRuntimeStyleOptions, a as TileflowSessionController, ba as TileflowSessionGrantResponse, bb as TileflowStreetsBasemapConfig, bc as TileflowStreetsCompileOptions, bd as TileflowStreetsMapConfig, be as TileflowStreetsModules, bf as TileflowStreetsOptions, bg as TileflowStreetsVariant, bh as TileflowStyleOptions, bi as TileflowStyleValue, bj as TileflowSymbolPlacement, bk as TileflowSymbolPlacementStyle, bl as TileflowSymbolStyle, bm as TileflowSymbolZOrder, bn as TileflowTerrain, bo as TileflowTerrainConfig, bp as TileflowTerrainEncoding, bq as TileflowTerrainMode, br as TileflowTextAnchor, bs as TileflowTextJustify, bt as TileflowTextLayout, bu as TileflowTextPaint, bv as TileflowTextStyle, bw as TileflowTheme, bx as TileflowThemeConfig, by as TileflowThemeMode, bz as TileflowThemeModulesConfig, bA as TileflowThemeName, bB as TileflowTransitModuleConfig, bC as TileflowTransitModuleOptions, bD as TileflowTransitRailStyle, bE as TileflowTypography, bF as TileflowTypographyDomain, bG as TileflowTypographyStyle, bH as TileflowViewConfig, bI as TileflowWaterLabelClass, bJ as TileflowWaterModuleConfig, bK as TileflowWaterModuleOptions, bL as TileflowWaterwayClass, bM as TileflowWorldData, bN as TileflowZoomInterpolation, bO as TileflowZoomValue, bP as ValidationMessage, bQ as VectorTilesData, bR as addLayer, bS as aeroways, bT as boundaries, bU as buildings, bV as createManifest, bW as createStreetsStyle, bX as createStyle, bY as createStyleFromProject, bZ as createTileflowSessionController, b_ as createTileflowSessionId, b$ as defaultTileflowManifestUrl, c0 as defaultTileflowStyleBaseUrl, c1 as expression, c2 as filter, c3 as getDefaultTileflowStyleBaseUrl, c4 as getTileflowAnalyticsApiUrl, c5 as inferTileflowAnalyticsFromStyleUrl, c6 as isCanonicalOpenMapTilesSchema, c7 as isTileflowLocalDevHost, c8 as land, c9 as loadTileflowManifest, ca as mergeTileflowAnalytics, cb as moveLayer, cc as normalizeTileflowCaptureId, cd as normalizeTileflowCaptureScene, ce as normalizeTileflowStaticImageSize, cf as normalizeTileflowUrl, cg as openMapTiles, ch as openMapTilesContractVersion, ci as patchLayer, cj as removeLayer, ck as resolveTileflowAnalyticsRequestUrl, cl as resolveTileflowData, cm as resolveTileflowManifestMap, cn as resolveTileflowMapMode, co as resolveTileflowRuntimeStyle, cp as resolveTileflowStaticImageUrl, cq as resolveTileflowStyleUrl, cr as shouldLoadTileflowManifest, cs as startTileflowSession, ct as streets, cu as tileflowCaptureApplicationTargetSchema, cv as tileflowCaptureBoundsCameraSchema, cw as tileflowCaptureCameraSchema, cx as tileflowCaptureCenterCameraSchema, cy as tileflowCaptureIdSchema, cz as tileflowCaptureMapTargetSchema, cA as tileflowCaptureSceneLimits, cB as tileflowCaptureSceneNameSchema, cC as tileflowCaptureSceneSchema, cD as tileflowCaptureSceneSchemaVersion, cE as tileflowCaptureTargetSchema, cF as tileflowCaptureViewportSchema, cG as tileflowFontStack, cH as tileflowHostedNotoSansWeights, cI as tileflowPrimarySourceId, cJ as tileflowStreetsBasemapVersion, cK as tileflowStreetsPoiIconMapping, cL as tileflowWorld, cM as tileflowWorldRevision, cN as transit, cO as vectorTiles, cP as water, cQ as zoom } from './runtime-Dd_xGAXq.js';
+import { b as TileflowBaseColors, c as TileflowConfig, d as TileflowProjectConfig, V as ValidationResult, e as TileflowRoadsModuleOptions, f as TileflowRoadsModuleConfig, g as TileflowLabelsModuleOptions, h as TileflowLabelsModuleConfig, i as TileflowPoiModuleOptions, j as TileflowPoiModuleConfig } from './runtime-DroKDIuB.js';
+export { M as MapLibreSprite, k as MapLibreStyle, N as NormalizedTileflowCaptureScene, O as OpenMapTilesFieldBindings, l as OpenMapTilesLayerBindings, m as OpenMapTilesSchema, n as OpenMapTilesSchemaOptions, R as ResolvedTileflowData, o as ResolvedTileflowTypography, p as TileflowAerowaysModuleConfig, q as TileflowAerowaysModuleOptions, r as TileflowAlignment, T as TileflowAnalytics, s as TileflowAreaStyle, t as TileflowBackgroundPaint, u as TileflowBackgroundStyle, v as TileflowBoundariesModuleConfig, w as TileflowBoundariesModuleOptions, x as TileflowBoundaryColorConfig, y as TileflowBuildingColorConfig, z as TileflowBuildingMode, A as TileflowBuildingsModuleConfig, B as TileflowBuildingsModuleOptions, C as TileflowCaptureApplicationTarget, D as TileflowCaptureBoundsCamera, E as TileflowCaptureCamera, F as TileflowCaptureCenterCamera, G as TileflowCaptureMapTarget, H as TileflowCaptureScene, I as TileflowCaptureTarget, J as TileflowCaptureViewport, K as TileflowCirclePaint, L as TileflowCircleStyle, P as TileflowColor, Q as TileflowColorConfig, S as TileflowColors, U as TileflowDataConfig, W as TileflowDataIdentity, X as TileflowExpression, Y as TileflowExtrusionPaint, Z as TileflowExtrusionStyle, _ as TileflowFillPaint, $ as TileflowFillStyle, a0 as TileflowFilterExpression, a1 as TileflowFontWeight, a2 as TileflowHostedNotoSansWeight, a3 as TileflowHydroColorConfig, a4 as TileflowIconAnchor, a5 as TileflowIconLayout, a6 as TileflowIconPaint, a7 as TileflowIconSet, a8 as TileflowIconSetConfig, a9 as TileflowIconStyle, aa as TileflowLabelColorConfig, ab as TileflowLabelDetail, ac as TileflowLabelLanguage, ad as TileflowLabelStyles, ae as TileflowLandModuleConfig, af as TileflowLandModuleOptions, ag as TileflowLandcoverClass, ah as TileflowLandcoverColorConfig, ai as TileflowLanduseClass, aj as TileflowLanduseColorConfig, ak as TileflowLayerPlacement, al as TileflowLayerRange, am as TileflowLineCap, an as TileflowLineHatchStyle, ao as TileflowLineJoin, ap as TileflowLineLayout, aq as TileflowLinePaint, ar as TileflowLineStackStyle, as as TileflowLineStyle, at as TileflowManifest, au as TileflowManifestLoadOptions, av as TileflowMapConfig, aw as TileflowMapMarker, ax as TileflowMapMode, ay as TileflowMapModeOptions, az as TileflowMountainBikeScale, aA as TileflowPlaceLabelClass, aB as TileflowPoi, aC as TileflowPoiCategory, aD as TileflowPoiCategoryStyle, aE as TileflowPoiClassMapping, aF as TileflowPoiColorConfig, aG as TileflowPoiColorMode, aH as TileflowPoiDensity, aI as TileflowPoiIcons, aJ as TileflowPoiLabels, aK as TileflowProjectIconSets, aL as TileflowProjectThemes, aM as TileflowRawOverride, aN as TileflowRoadAreaStyle, aO as TileflowRoadClass, aP as TileflowRoadClassStyle, aQ as TileflowRoadColorConfig, aR as TileflowRoadDetail, aS as TileflowRoadExtras, aT as TileflowRoadHierarchy, aU as TileflowRoadLabelDetail, aV as TileflowRoadLayerStyle, aW as TileflowRoadModifier, aX as TileflowRoadOutline, aY as TileflowRoadRestriction, aZ as TileflowRoadServiceType, a_ as TileflowRoadShieldDetail, a$ as TileflowRoadShieldStyles, b0 as TileflowRoadStructure, b1 as TileflowRoadTreatmentLayerStyle, b2 as TileflowRoadTreatmentLineStyle, b3 as TileflowRoadTreatmentStyle, b4 as TileflowRoadWeight, b5 as TileflowRuntimeManifest, b6 as TileflowRuntimeManifestMap, b7 as TileflowRuntimeManifestMapEntry, b8 as TileflowRuntimeStyle, b9 as TileflowRuntimeStyleOptions, a as TileflowSessionController, ba as TileflowSessionGrantResponse, bb as TileflowStreetsBasemapConfig, bc as TileflowStreetsCompileOptions, bd as TileflowStreetsMapConfig, be as TileflowStreetsModules, bf as TileflowStreetsOptions, bg as TileflowStreetsVariant, bh as TileflowStyleOptions, bi as TileflowStyleValue, bj as TileflowSymbolPlacement, bk as TileflowSymbolPlacementStyle, bl as TileflowSymbolStyle, bm as TileflowSymbolZOrder, bn as TileflowTerrain, bo as TileflowTerrainConfig, bp as TileflowTerrainEncoding, bq as TileflowTerrainMode, br as TileflowTextAnchor, bs as TileflowTextJustify, bt as TileflowTextLayout, bu as TileflowTextPaint, bv as TileflowTextStyle, bw as TileflowTheme, bx as TileflowThemeConfig, by as TileflowThemeMode, bz as TileflowThemeModulesConfig, bA as TileflowThemeName, bB as TileflowTransitModuleConfig, bC as TileflowTransitModuleOptions, bD as TileflowTransitRailStyle, bE as TileflowTypography, bF as TileflowTypographyDomain, bG as TileflowTypographyStyle, bH as TileflowViewConfig, bI as TileflowWaterLabelClass, bJ as TileflowWaterModuleConfig, bK as TileflowWaterModuleOptions, bL as TileflowWaterwayClass, bM as TileflowWorldData, bN as TileflowZoomInterpolation, bO as TileflowZoomValue, bP as ValidationMessage, bQ as VectorTilesData, bR as addLayer, bS as aeroways, bT as boundaries, bU as buildings, bV as createManifest, bW as createStreetsStyle, bX as createStyle, bY as createStyleFromProject, bZ as createTileflowSessionController, b_ as createTileflowSessionId, b$ as defaultTileflowManifestUrl, c0 as defaultTileflowStyleBaseUrl, c1 as expression, c2 as filter, c3 as getDefaultTileflowStyleBaseUrl, c4 as getTileflowAnalyticsApiUrl, c5 as inferTileflowAnalyticsFromStyleUrl, c6 as isCanonicalOpenMapTilesSchema, c7 as isTileflowLocalDevHost, c8 as land, c9 as loadTileflowManifest, ca as mergeTileflowAnalytics, cb as moveLayer, cc as normalizeTileflowCaptureId, cd as normalizeTileflowCaptureScene, ce as normalizeTileflowStaticImageSize, cf as normalizeTileflowUrl, cg as openMapTiles, ch as openMapTilesContractVersion, ci as patchLayer, cj as removeLayer, ck as resolveTileflowAnalyticsRequestUrl, cl as resolveTileflowData, cm as resolveTileflowManifestMap, cn as resolveTileflowMapMode, co as resolveTileflowRuntimeStyle, cp as resolveTileflowStaticImageUrl, cq as resolveTileflowStyleUrl, cr as shouldLoadTileflowManifest, cs as startTileflowSession, ct as streets, cu as tileflowCaptureApplicationTargetSchema, cv as tileflowCaptureBoundsCameraSchema, cw as tileflowCaptureCameraSchema, cx as tileflowCaptureCenterCameraSchema, cy as tileflowCaptureIdSchema, cz as tileflowCaptureMapTargetSchema, cA as tileflowCaptureSceneLimits, cB as tileflowCaptureSceneNameSchema, cC as tileflowCaptureSceneSchema, cD as tileflowCaptureSceneSchemaVersion, cE as tileflowCaptureTargetSchema, cF as tileflowCaptureViewportSchema, cG as tileflowFontStack, cH as tileflowHostedNotoSansWeights, cI as tileflowPrimarySourceId, cJ as tileflowStreetsBasemapVersion, cK as tileflowStreetsPoiIconMapping, cL as tileflowWorld, cM as tileflowWorldRevision, cN as transit, cO as vectorTiles, cP as water, cQ as zoom } from './runtime-DroKDIuB.js';
 import { z } from 'zod';
 
 declare function getDefaultColors(): TileflowBaseColors;

package/dist/index.js

@@ -511,6 +511,7 @@ var canonicalLayers = {
   aeroway: "aeroway",
   boundary: "boundary",
   building: "building",
+  globalLandcover: "globallandcover",
   landcover: "landcover",
   landuse: "landuse",
   park: "park",
@@ -562,7 +563,11 @@ function openMapTiles(options = {}) {
     type: "openmaptiles",
     contractVersion: openMapTilesContractVersion,
     fields: { ...canonicalFields, ...options.fields },
-    layers: { ...canonicalLayers, ...options.layers }
+    layers: {
+      ...canonicalLayers,
+      ...options.layers,
+      globalLandcover: options.layers?.globalLandcover ?? canonicalLayers.globalLandcover
+    }
   };
 }
 function tileflowWorld(options = {}) {
@@ -592,7 +597,7 @@ function resolveTileflowData(data, options = {}) {
     url.searchParams.set("archiveVersion", revision);
     const schema2 = openMapTiles();
     return {
-      attribution: defaultAttribution,
+      ...revision === tileflowWorldRevision ? { attribution: defaultAttribution } : {},
       identity: dataIdentity(descriptor.type, schema2, revision),
       kind: descriptor.type,
       revision,
@@ -614,7 +619,7 @@ function resolveTileflowData(data, options = {}) {
 }
 function isCanonicalOpenMapTilesSchema(schema) {
   return Object.entries(canonicalLayers).every(
-    ([key, value]) => schema.layers[key] === value
+    ([key, value]) => (schema.layers[key] ?? (key === "globalLandcover" ? canonicalLayers.globalLandcover : void 0)) === value
   ) && Object.entries(canonicalFields).every(
     ([key, value]) => schema.fields[key] === value
   );
@@ -679,7 +684,10 @@ function validateOpenMapTilesSchema(schema) {
   return {
     ...schema,
     fields: { ...schema.fields },
-    layers: { ...schema.layers }
+    layers: {
+      ...schema.layers,
+      globalLandcover: schema.layers.globalLandcover ?? canonicalLayers.globalLandcover
+    }
   };
 }
 function validateRevision(value) {
@@ -1608,21 +1616,34 @@ function symbolContribution(target, localOrder, layer) {
 // src/modules/land/compiler.ts
 var landuseClasses = {
   cemetery: ["cemetery"],
-  civic: ["school", "university", "hospital", "civic"],
+  civic: [
+    "school",
+    "university",
+    "hospital",
+    "civic",
+    "college",
+    "kindergarten",
+    "education",
+    "library"
+  ],
   commercial: ["commercial", "retail"],
   industrial: ["industrial"],
+  military: ["military"],
   railway: ["railway"],
+  recreation: ["pitch", "track", "playground", "zoo"],
   residential: ["residential"]
 };
 var landcoverClasses = {
-  farmland: ["farmland"],
-  grass: ["grass"],
-  ice: ["ice", "glacier"],
-  park: ["park"],
-  protected: ["protected_area"],
-  sand: ["sand", "beach"],
-  scrub: ["scrub"],
-  wood: ["wood", "forest"]
+  farmland: { class: ["farmland"] },
+  grass: { class: ["grass"] },
+  ice: { class: ["ice", "glacier"] },
+  park: { class: ["park"] },
+  protected: { class: ["protected_area"] },
+  rock: { class: ["rock"] },
+  sand: { class: ["sand", "beach"] },
+  scrub: { class: ["grass"], subclass: ["scrub"] },
+  wetland: { class: ["wetland"] },
+  wood: { class: ["wood", "forest"] }
 };
 function compileLand(request, context) {
   const colors = context.colors;
@@ -1636,7 +1657,9 @@ function compileLand(request, context) {
         civic: { fill: { color: colors.landuse.civic, opacity: 0.62 } },
         commercial: { fill: { color: colors.landuse.commercial, opacity: 0.62 } },
         industrial: { fill: { color: colors.landuse.industrial, opacity: 0.62 } },
+        military: { fill: { color: colors.landuse.military, opacity: 0.5 } },
         railway: { fill: { color: colors.landuse.industrial, opacity: 0.62 } },
+        recreation: { fill: { color: colors.landuse.recreation, opacity: 0.62 } },
         residential: { fill: { color: colors.landuse.residential, opacity: 0.62 } }
       },
       landcover: {
@@ -1645,8 +1668,10 @@ function compileLand(request, context) {
         ice: { fill: { color: colors.landcover.ice, opacity: 0.88 } },
         park: { fill: { color: colors.landcover.park, opacity: 0.78 } },
         protected: { fill: { color: colors.landcover.protected, opacity: 0.88 } },
+        rock: { fill: { color: colors.landcover.rock, opacity: 0.85 } },
         sand: { fill: { color: colors.landcover.sand, opacity: 0.88 } },
         scrub: { fill: { color: colors.landcover.protected, opacity: 0.88 } },
+        wetland: { fill: { color: colors.landcover.wetland, opacity: 0.82 } },
         wood: { fill: { color: colors.landcover.wood, opacity: 0.88 } }
       }
     },
@@ -1656,6 +1681,7 @@ function compileLand(request, context) {
   const source = context.data.sourceId;
   const schema = context.data.schema;
   const classField = schema.fields.class;
+  const subclassField = schema.fields.subclass;
   const contributions = [];
   if (config.background?.visible !== false) {
     const background = config.background ?? {};
@@ -1674,6 +1700,43 @@ function compileLand(request, context) {
       target: "land.background"
     });
   }
+  contributions.push({
+    kind: "layer",
+    layer: {
+      id: "streets-global-landcover",
+      type: "fill",
+      source,
+      "source-layer": schema.layers.globalLandcover ?? "globallandcover",
+      minzoom: 0,
+      maxzoom: 8,
+      paint: {
+        "fill-color": [
+          "match",
+          ["get", classField],
+          "barren",
+          colors.landcover.rock,
+          "crop",
+          colors.roadMajor,
+          "grass",
+          colors.landcover.grass,
+          "shrub",
+          colors.landcover.protected,
+          "snow",
+          colors.landcover.ice,
+          "trees",
+          colors.landcover.wood,
+          "urban",
+          colors.building,
+          "rgba(0, 0, 0, 0)"
+        ],
+        "fill-opacity": ["interpolate", ["linear"], ["zoom"], 0, 0.88, 6, 0.82, 7, 0.68, 8, 0]
+      }
+    },
+    localOrder: 10,
+    owner: "land",
+    slot: "land",
+    target: "land.globalLandcover"
+  });
   let localOrder = 100;
   for (const [name, classes] of Object.entries(landuseClasses)) {
     const style = config.landuse?.[name];
@@ -1698,7 +1761,7 @@ function compileLand(request, context) {
       });
     }
   }
-  for (const [name, classes] of Object.entries(landcoverClasses)) {
+  for (const [name, match] of Object.entries(landcoverClasses)) {
     const style = config.landcover?.[name];
     if (!style) continue;
     const sourceLayer = name === "park" ? schema.layers.park : schema.layers.landcover;
@@ -1708,7 +1771,7 @@ function compileLand(request, context) {
         type: "fill",
         source,
         "source-layer": sourceLayer,
-        ...name === "park" ? {} : { filter: classFilter2(classField, classes) }
+        ...name === "park" ? {} : { filter: landcoverFilter(classField, subclassField, match) }
       },
       style
     )) {
@@ -1727,6 +1790,11 @@ function compileLand(request, context) {
 function classFilter2(field, classes) {
   return ["match", ["get", field], classes, true, false];
 }
+function landcoverFilter(classField, subclassField, match) {
+  const filter2 = classFilter2(classField, match.class);
+  if (!match.subclass) return filter2;
+  return ["all", filter2, classFilter2(subclassField, match.subclass)];
+}
 
 // src/modules/poi/compiler.ts
 function compilePoi(request, context) {
@@ -2091,6 +2159,8 @@ function resolveColors(overrides = {}, defaults3 = defaultColors, moduleOverride
     civic: mix(base.land, base.textMuted, 0.08),
     commercial: mix(base.land, base.textMuted, 0.05),
     industrial: mix(base.land, base.text, 0.04),
+    military: mix(base.land, base.textMuted, 0.16),
+    recreation: mix(base.park, base.land, 0.15),
     residential: mix(base.land, base.background, 0.35)
   };
   const landcoverDefaults = {
@@ -2098,7 +2168,9 @@ function resolveColors(overrides = {}, defaults3 = defaultColors, moduleOverride
     ice: mix(base.water, base.background, 0.65),
     park: base.park,
     protected: mix(base.park, base.textMuted, 0.08),
+    rock: mix(base.land, base.text, 0.12),
     sand: mix(base.land, base.roadMajor, 0.1),
+    wetland: mix(base.water, base.park, 0.35),
     wood: mix(base.park, base.text, 0.08)
   };
   const hydroDefaults = {
@@ -3423,7 +3495,7 @@ function createStreetsStyle(config, options = {}) {
       [data.sourceId]: {
         type: "vector",
         url: data.url,
-        attribution: data.attribution
+        ...data.attribution ? { attribution: data.attribution } : {}
       },
       ...terrain ? { [terrain.sourceId]: terrain.source } : {}
     },
@@ -4194,6 +4266,7 @@ var layerBindingsSchema = z2.object({
   aeroway: z2.string().trim().min(1),
   boundary: z2.string().trim().min(1),
   building: z2.string().trim().min(1),
+  globalLandcover: z2.string().trim().min(1),
   landcover: z2.string().trim().min(1),
   landuse: z2.string().trim().min(1),
   park: z2.string().trim().min(1),

package/dist/{runtime-Dd_xGAXq.d.ts → runtime-DroKDIuB.d.ts}

@@ -373,8 +373,8 @@ type TileflowBuildingsModuleConfig = TileflowBuildingsModuleOptions & {
 };
 declare function buildings(options?: TileflowBuildingsModuleOptions): TileflowBuildingsModuleConfig;
 
-type TileflowLanduseClass = 'cemetery' | 'civic' | 'commercial' | 'industrial' | 'railway' | 'residential';
-type TileflowLandcoverClass = 'farmland' | 'grass' | 'ice' | 'park' | 'protected' | 'sand' | 'scrub' | 'wood';
+type TileflowLanduseClass = 'cemetery' | 'civic' | 'commercial' | 'industrial' | 'military' | 'railway' | 'recreation' | 'residential';
+type TileflowLandcoverClass = 'farmland' | 'grass' | 'ice' | 'park' | 'protected' | 'rock' | 'sand' | 'scrub' | 'wetland' | 'wood';
 type TileflowLandModuleOptions = {
     background?: TileflowBackgroundStyle;
     enabled?: boolean;
@@ -479,6 +479,8 @@ type TileflowLanduseColorConfig = {
     civic?: TileflowColor;
     commercial?: TileflowColor;
     industrial?: TileflowColor;
+    military?: TileflowColor;
+    recreation?: TileflowColor;
     residential?: TileflowColor;
 };
 type TileflowLandcoverColorConfig = {
@@ -486,7 +488,9 @@ type TileflowLandcoverColorConfig = {
     ice?: TileflowColor;
     park?: TileflowColor;
     protected?: TileflowColor;
+    rock?: TileflowColor;
     sand?: TileflowColor;
+    wetland?: TileflowColor;
     wood?: TileflowColor;
 };
 type TileflowHydroColorConfig = {
@@ -759,6 +763,8 @@ type OpenMapTilesLayerBindings = {
     aeroway: string;
     boundary: string;
     building: string;
+    /** Optional low-zoom global land-cover extension. Defaults to `globallandcover`. */
+    globalLandcover?: string;
     landcover: string;
     landuse: string;
     park: string;
@@ -834,7 +840,8 @@ type TileflowDataIdentity = {
     sourceId: typeof tileflowPrimarySourceId;
 };
 type ResolvedTileflowData = {
-    attribution: string;
+    /** Omitted when the versioned TileJSON is the authoritative attribution source. */
+    attribution?: string;
     identity: TileflowDataIdentity;
     kind: TileflowDataConfig['type'];
     revision?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tileflow/core",
-  "version": "0.1.0-alpha.19",
+  "version": "0.1.0-alpha.20",
   "description": "Typed Tileflow config and MapLibre style compiler.",
   "type": "module",
   "sideEffects": false,