@mapbox/mapbox-gl-style-spec 13.19.1 → 13.20.1

package/dist/index.es.js

@@ -60,6 +60,10 @@ var $root = {
 		type: "terrain",
 		doc: "A global modifier that elevates layers and markers based on a DEM data source."
 	},
+	fog: {
+		type: "fog",
+		doc: "A global effect that fades layers and markers based on their distance to the camera. The fog can be used to approximate the effect of atmosphere on distant objects and enhance the depth perception of the map when used with terrain or 3D features."
+	},
 	sources: {
 		required: true,
 		type: "sources",
@@ -859,15 +863,19 @@ var layout_line = {
 				android: "2.0.1",
 				ios: "2.0.0",
 				macos: "0.1.0"
+			},
+			"data-driven styling": {
+				js: "2.3.0"
 			}
 		},
 		expression: {
 			interpolated: false,
 			parameters: [
-				"zoom"
+				"zoom",
+				"feature"
 			]
 		},
-		"property-type": "data-constant"
+		"property-type": "data-driven"
 	},
 	"line-join": {
 		type: "enum",
@@ -1837,15 +1845,19 @@ var layout_symbol = {
 				android: "2.0.1",
 				ios: "2.0.0",
 				macos: "0.1.0"
+			},
+			"data-driven styling": {
+				js: "2.3.0"
 			}
 		},
 		expression: {
 			interpolated: true,
 			parameters: [
-				"zoom"
+				"zoom",
+				"feature"
 			]
 		},
-		"property-type": "data-constant"
+		"property-type": "data-driven"
 	},
 	"text-letter-spacing": {
 		type: "number",
@@ -2646,7 +2658,7 @@ var expression_name = {
 			}
 		},
 		match: {
-			doc: "Selects the output whose label value matches the input value, or the fallback value if no match is found. The input can be any expression (e.g. `[\"get\", \"building_type\"]`). Each label must be either:\n - a single literal value; or\n - an array of literal values, whose values must be all strings or all numbers (e.g. `[100, 101]` or `[\"c\", \"b\"]`). The input matches if any of the values in the array matches, similar to the `\"in\"` operator.\nEach label must be unique. If the input type does not match the type of the labels, the result will be the fallback value.",
+			doc: "Selects the output for which the label value matches the input value, or the fallback value if no match is found. The input can be any expression (for example, `[\"get\", \"building_type\"]`). Each label must be unique, and must be either:\n - a single literal value; or\n - an array of literal values, the values of which must be all strings or all numbers (for example `[100, 101]` or `[\"c\", \"b\"]`).\n\nThe input matches if any of the values in the array matches using strict equality, similar to the `\"in\"` operator.\nIf the input type does not match the type of the labels, the result will be the fallback value.",
 			group: "Decision",
 			"sdk-support": {
 				"basic functionality": {
@@ -3586,6 +3598,75 @@ var expression_name = {
 		}
 	}
 };
+var fog = {
+	range: {
+		type: "array",
+		"default": [
+			0.5,
+			10
+		],
+		minimum: -20,
+		maximum: 20,
+		length: 2,
+		value: "number",
+		"property-type": "data-constant",
+		transition: true,
+		expression: {
+			interpolated: true,
+			parameters: [
+				"zoom"
+			]
+		},
+		doc: "The start and end distance range in which fog fades from fully transparent to fully opaque. The distance to the point at the center of the map is defined as zero, so that negative range values are closer to the camera, and positive values are farther away.",
+		example: [
+			0.5,
+			10
+		],
+		"sdk-support": {
+			"basic functionality": {
+				js: "2.3.0"
+			}
+		}
+	},
+	color: {
+		type: "color",
+		"property-type": "data-constant",
+		"default": "#ffffff",
+		expression: {
+			interpolated: true,
+			parameters: [
+				"zoom"
+			]
+		},
+		transition: true,
+		doc: "The color of the fog. Using opacity is recommended only for smoothly transitioning fog on/off as anything less than 100% opacity results in more tiles loaded and drawn.",
+		"sdk-support": {
+			"basic functionality": {
+				js: "2.3.0"
+			}
+		}
+	},
+	"horizon-blend": {
+		type: "number",
+		"property-type": "data-constant",
+		"default": 0.1,
+		minimum: 0,
+		maximum: 1,
+		expression: {
+			interpolated: true,
+			parameters: [
+				"zoom"
+			]
+		},
+		transition: true,
+		doc: "Horizon blend applies a smooth fade from the color of the fog to the color of the sky. A value of zero leaves a sharp transition from fog to sky. Increasing the value blends the color of fog into increasingly high angles of the sky.",
+		"sdk-support": {
+			"basic functionality": {
+				js: "2.3.0"
+			}
+		}
+	}
+};
 var light = {
 	anchor: {
 		type: "enum",
@@ -4213,15 +4294,17 @@ var paint_line = {
 				macos: "0.1.0"
 			},
 			"data-driven styling": {
+				js: "2.3.0"
 			}
 		},
 		expression: {
 			interpolated: false,
 			parameters: [
-				"zoom"
+				"zoom",
+				"feature"
 			]
 		},
-		"property-type": "cross-faded"
+		"property-type": "cross-faded-data-driven"
 	},
 	"line-pattern": {
 		type: "resolvedImage",
@@ -5995,6 +6078,7 @@ var v8 = {
 	function_stop: function_stop,
 	expression: expression,
 	expression_name: expression_name,
+	fog: fog,
 	light: light,
 	terrain: terrain,
 	paint: paint,
@@ -12800,7 +12884,8 @@ const operations = {
     setGlyphs: 'setGlyphs',
     setTransition: 'setTransition',
     setLight: 'setLight',
-    setTerrain: 'setTerrain'
+    setTerrain: 'setTerrain',
+    setFog: 'setFog'
 };
 function addSource(sourceId, after, commands) {
     commands.push({
@@ -13101,6 +13186,12 @@ function diffStyles(before, after) {
                 args: [after.light]
             });
         }
+        if (!deepEqual(before.fog, after.fog)) {
+            commands.push({
+                command: operations.setFog,
+                args: [after.fog]
+            });
+        }
         const sourcesRemoved = {};
         const removeOrAddSourceCommands = [];
         diffSources(before.sources, after.sources, removeOrAddSourceCommands, sourcesRemoved);
@@ -14040,6 +14131,44 @@ function validateTerrain(options) {
     return errors;
 }
 
+function validateFog(options) {
+    const fog = options.value;
+    const style = options.style;
+    const styleSpec = options.styleSpec;
+    const fogSpec = styleSpec.fog;
+    let errors = [];
+    const rootType = getType(fog);
+    if (fog === undefined) {
+        return errors;
+    } else if (rootType !== 'object') {
+        errors = errors.concat([new ValidationError('fog', fog, `object expected, ${ rootType } found`)]);
+        return errors;
+    }
+    for (const key in fog) {
+        const transitionMatch = key.match(/^(.*)-transition$/);
+        if (transitionMatch && fogSpec[transitionMatch[1]] && fogSpec[transitionMatch[1]].transition) {
+            errors = errors.concat(validate({
+                key,
+                value: fog[key],
+                valueSpec: styleSpec.transition,
+                style,
+                styleSpec
+            }));
+        } else if (fogSpec[key]) {
+            errors = errors.concat(validate({
+                key,
+                value: fog[key],
+                valueSpec: fogSpec[key],
+                style,
+                styleSpec
+            }));
+        } else {
+            errors = errors.concat([new ValidationError(key, fog[key], `unknown property "${ key }"`)]);
+        }
+    }
+    return errors;
+}
+
 function validateFormatted(options) {
     if (validateString(options).length === 0) {
         return [];
@@ -14071,6 +14200,7 @@ const VALIDATORS = {
     'source': validateSource,
     'light': validateLight,
     'terrain': validateTerrain,
+    'fog': validateFog,
     'string': validateString,
     'formatted': validateFormatted,
     'resolvedImage': validateImage
@@ -14134,6 +14264,7 @@ function validateStyleMin(style, styleSpec = v8) {
 validateStyleMin.source = wrapCleanErrors(validateSource);
 validateStyleMin.light = wrapCleanErrors(validateLight);
 validateStyleMin.terrain = wrapCleanErrors(validateTerrain);
+validateStyleMin.fog = wrapCleanErrors(validateFog);
 validateStyleMin.layer = wrapCleanErrors(validateLayer);
 validateStyleMin.filter = wrapCleanErrors(validateFilter);
 validateStyleMin.paintProperty = wrapCleanErrors(validatePaintProperty);
@@ -14854,6 +14985,11 @@ function getAllowedKeyErrors(obj, keys, path) {
     });
     return errors;
 }
+const acceptedSourceTypes = new Set([
+    'vector',
+    'raster',
+    'raster-dem'
+]);
 function getSourceErrors(source, i) {
     const errors = [];
     const sourceKeys = [
@@ -14862,9 +14998,12 @@ function getSourceErrors(source, i) {
         'tileSize'
     ];
     errors.push(...getAllowedKeyErrors(source, sourceKeys, 'source'));
+    if (!acceptedSourceTypes.has(String(source.type))) {
+        errors.push(new ValidationError(`sources[${ i }].type`, source.type, `Expected one of [${ Array.from(acceptedSourceTypes).join(', ') }]`));
+    }
     const sourceUrlPattern = /^mapbox:\/\/([^/]*)$/;
-    if (!isValid(source.url, sourceUrlPattern)) {
-        errors.push(new ValidationError(`sources[${ i }]`, source.url, 'Source url must be a valid Mapbox tileset url'));
+    if (!source.url || !isValid(source.url, sourceUrlPattern)) {
+        errors.push(new ValidationError(`sources[${ i }].url`, source.url, 'Expected a valid Mapbox tileset url'));
     }
     return errors;
 }