@mapbox/mapbox-gl-style-spec 13.19.2 → 13.21.0

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",
@@ -611,7 +615,9 @@ var layer = {
 				doc: "A spherical dome around the map that is always rendered behind all other layers.",
 				"sdk-support": {
 					"basic functionality": {
-						js: "2.0.0"
+						js: "2.0.0",
+						ios: "10.0.0",
+						android: "10.0.0"
 					}
 				}
 			}
@@ -707,7 +713,9 @@ var layout_sky = {
 		doc: "Whether this layer is displayed.",
 		"sdk-support": {
 			"basic functionality": {
-				js: "2.0.0"
+				js: "2.0.0",
+				ios: "10.0.0",
+				android: "10.0.0"
 			}
 		},
 		"property-type": "constant"
@@ -859,15 +867,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",
@@ -1798,7 +1810,12 @@ var layout_symbol = {
 		units: "ems",
 		doc: "The maximum line width for text wrapping.",
 		requires: [
-			"text-field"
+			"text-field",
+			{
+				"symbol-placement": [
+					"point"
+				]
+			}
 		],
 		"sdk-support": {
 			"basic functionality": {
@@ -1837,15 +1854,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",
@@ -2113,20 +2134,15 @@ var layout_symbol = {
 		value: "enum",
 		values: {
 			horizontal: {
-				doc: "If a text's language supports horizontal writing mode, symbols with point placement would be laid out horizontally."
+				doc: "If a text's language supports horizontal writing mode, symbols would be laid out horizontally."
 			},
 			vertical: {
-				doc: "If a text's language supports vertical writing mode, symbols with point placement would be laid out vertically."
+				doc: "If a text's language supports vertical writing mode, symbols would be laid out vertically."
 			}
 		},
-		doc: "The property allows control over a symbol's orientation. Note that the property values act as a hint, so that a symbol whose language doesn’t support the provided orientation will be laid out in its natural orientation. Example: English point symbol will be rendered horizontally even if array value contains single 'vertical' enum value. The order of elements in an array define priority order for the placement of an orientation variant.",
+		doc: "The property allows control over a symbol's orientation. Note that the property values act as a hint, so that a symbol whose language doesn’t support the provided orientation will be laid out in its natural orientation. Example: English point symbol will be rendered horizontally even if array value contains single 'vertical' enum value. For symbol with point placement, the order of elements in an array define priority order for the placement of an orientation variant. For symbol with line placement, the default text writing mode is either ['horizontal', 'vertical'] or ['vertical', 'horizontal'], the order doesn't affect the placement.",
 		requires: [
-			"text-field",
-			{
-				"symbol-placement": [
-					"point"
-				]
-			}
+			"text-field"
 		],
 		"sdk-support": {
 			"basic functionality": {
@@ -2604,7 +2620,7 @@ var expression_name = {
 			}
 		},
 		"in": {
-			doc: "Determines whether an item exists in an array or a substring exists in a string.",
+			doc: "Determines whether an item exists in an array or a substring exists in a string. In the specific case when the second and third arguments are string literals, you must wrap at least one of them in a [`literal`](#types-literal) expression to hint correct interpretation to the [type system](#type-system).",
 			group: "Lookup",
 			"sdk-support": {
 				"basic functionality": {
@@ -2646,7 +2662,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": {
@@ -2872,7 +2888,10 @@ var expression_name = {
 			group: "Types",
 			"sdk-support": {
 				"basic functionality": {
-					js: "0.54.0"
+					js: "0.54.0",
+					android: "8.4.0",
+					ios: "5.4.0",
+					macos: "0.15.0"
 				}
 			}
 		},
@@ -3018,7 +3037,7 @@ var expression_name = {
 			}
 		},
 		"geometry-type": {
-			doc: "Gets the feature's geometry type: `Point`, `MultiPoint`, `LineString`, `MultiLineString`, `Polygon`, `MultiPolygon`.",
+			doc: "Gets the feature's geometry type: `Point`, `MultiPoint`, `LineString`, `MultiLineString`, `Polygon`, `MultiPolygon`. `Multi*` feature types are only returned in GeoJSON sources. When working with vector tile sources, use the singular forms.",
 			group: "Feature data",
 			"sdk-support": {
 				"basic functionality": {
@@ -3082,7 +3101,9 @@ var expression_name = {
 			group: "sky",
 			"sdk-support": {
 				"basic functionality": {
-					js: "2.0.0"
+					js: "2.0.0",
+					ios: "10.0.0",
+					android: "10.0.0"
 				}
 			}
 		},
@@ -3091,7 +3112,10 @@ var expression_name = {
 			group: "Feature data",
 			"sdk-support": {
 				"basic functionality": {
-					js: "0.53.0"
+					js: "0.53.0",
+					android: "8.4.0",
+					ios: "5.5.0",
+					macos: "0.15.0"
 				}
 			}
 		},
@@ -3586,6 +3610,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",
@@ -3701,7 +3794,9 @@ var terrain = {
 		required: true,
 		"sdk-support": {
 			"basic functionality": {
-				js: "2.0.0"
+				js: "2.0.0",
+				ios: "10.0.0",
+				android: "10.0.0"
 			}
 		}
 	},
@@ -3721,7 +3816,9 @@ var terrain = {
 		doc: "Exaggerates the elevation of the terrain by multiplying the data from the DEM with this value.",
 		"sdk-support": {
 			"basic functionality": {
-				js: "2.0.0"
+				js: "2.0.0",
+				ios: "10.0.0",
+				android: "10.0.0"
 			}
 		}
 	}
@@ -4213,15 +4310,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",
@@ -5642,7 +5741,9 @@ var paint_sky = {
 		doc: "The type of the sky",
 		"sdk-support": {
 			"basic functionality": {
-				js: "2.0.0"
+				js: "2.0.0",
+				ios: "10.0.0",
+				android: "10.0.0"
 			}
 		},
 		expression: {
@@ -5670,7 +5771,9 @@ var paint_sky = {
 		doc: "Position of the sun center [a azimuthal angle, p polar angle]. The azimuthal angle indicates the position of the sun relative to 0° north, where degrees proceed clockwise. The polar angle indicates the height of the sun, where 0° is directly above, at zenith, and 90° at the horizon. When this property is ommitted, the sun center is directly inherited from the light position.",
 		"sdk-support": {
 			"basic functionality": {
-				js: "2.0.0"
+				js: "2.0.0",
+				ios: "10.0.0",
+				android: "10.0.0"
 			}
 		},
 		requires: [
@@ -5700,7 +5803,9 @@ var paint_sky = {
 		doc: "Intensity of the sun as a light source in the atmosphere (on a scale from 0 to a 100). Setting higher values will brighten up the sky.",
 		"sdk-support": {
 			"basic functionality": {
-				js: "2.0.0"
+				js: "2.0.0",
+				ios: "10.0.0",
+				android: "10.0.0"
 			}
 		},
 		"property-type": "data-constant"
@@ -5731,7 +5836,9 @@ var paint_sky = {
 		doc: "Position of the gradient center [a azimuthal angle, p polar angle]. The azimuthal angle indicates the position of the gradient center relative to 0° north, where degrees proceed clockwise. The polar angle indicates the height of the gradient center, where 0° is directly above, at zenith, and 90° at the horizon.",
 		"sdk-support": {
 			"basic functionality": {
-				js: "2.0.0"
+				js: "2.0.0",
+				ios: "10.0.0",
+				android: "10.0.0"
 			}
 		},
 		expression: {
@@ -5756,7 +5863,9 @@ var paint_sky = {
 		doc: "The angular distance (measured in degrees) from `sky-gradient-center` up to which the gradient extends. A value of 180 causes the gradient to wrap around to the opposite direction from `sky-gradient-center`.",
 		"sdk-support": {
 			"basic functionality": {
-				js: "2.0.0"
+				js: "2.0.0",
+				ios: "10.0.0",
+				android: "10.0.0"
 			}
 		},
 		expression: {
@@ -5791,7 +5900,9 @@ var paint_sky = {
 		],
 		"sdk-support": {
 			"basic functionality": {
-				js: "2.0.0"
+				js: "2.0.0",
+				ios: "10.0.0",
+				android: "10.0.0"
 			},
 			"data-driven styling": {
 			}
@@ -5816,7 +5927,9 @@ var paint_sky = {
 		],
 		"sdk-support": {
 			"basic functionality": {
-				js: "2.0.0"
+				js: "2.0.0",
+				ios: "10.0.0",
+				android: "10.0.0"
 			}
 		},
 		"property-type": "data-constant"
@@ -5833,7 +5946,9 @@ var paint_sky = {
 		],
 		"sdk-support": {
 			"basic functionality": {
-				js: "2.0.0"
+				js: "2.0.0",
+				ios: "10.0.0",
+				android: "10.0.0"
 			}
 		},
 		"property-type": "data-constant"
@@ -5847,7 +5962,9 @@ var paint_sky = {
 		transition: true,
 		"sdk-support": {
 			"basic functionality": {
-				js: "2.0.0"
+				js: "2.0.0",
+				ios: "10.0.0",
+				android: "10.0.0"
 			}
 		},
 		expression: {
@@ -5995,6 +6112,7 @@ var v8 = {
 	function_stop: function_stop,
 	expression: expression,
 	expression_name: expression_name,
+	fog: fog,
 	light: light,
 	terrain: terrain,
 	paint: paint,
@@ -6215,6 +6333,7 @@ var v8 = {
 		"sdk-support": {
 			"basic functionality": {
 				js: "0.50.0",
+				android: "7.0.0",
 				ios: "4.7.0",
 				macos: "0.13.0"
 			}
@@ -12800,7 +12919,8 @@ const operations = {
     setGlyphs: 'setGlyphs',
     setTransition: 'setTransition',
     setLight: 'setLight',
-    setTerrain: 'setTerrain'
+    setTerrain: 'setTerrain',
+    setFog: 'setFog'
 };
 function addSource(sourceId, after, commands) {
     commands.push({
@@ -13101,6 +13221,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 +14166,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 +14235,7 @@ const VALIDATORS = {
     'source': validateSource,
     'light': validateLight,
     'terrain': validateTerrain,
+    'fog': validateFog,
     'string': validateString,
     'formatted': validateFormatted,
     'resolvedImage': validateImage
@@ -14134,6 +14299,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 +15020,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 +15033,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;
 }