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

package/CHANGELOG.md

@@ -1,10 +1,25 @@
-## 13.9.2
+# 13.21.0
 
-* Fixes critical missing file (`dist\index.js`) in 13.9.1 ([#10627](https://github.com/mapbox/mapbox-gl-js/pull/10627))
+### ✨ Features and improvements
+* Add support for `text-writing-mode` property when using `symbol-placement: line` text labels. ([#10647](https://github.com/mapbox/mapbox-gl-js/pull/10647))
+  * Note: This change will bring following changes for CJK text block:
+    * 1. For vertical CJK text, all the characters including Latin and Numbers will be vertically placed now. Previously, Latin and Numbers are horizontally placed.
+    * 2. For horizontal CJK text, it may have a slight horizontal shift due to the anchor shift.
+
+## 13.20.1
+
+### 🐞 Bug fixes
 
-## 13.9.1 (Deprecated)
+* Increase strictness of the style API validation for source types ([#10779](https://github.com/mapbox/mapbox-gl-js/pull/10779))
+* Remove strictly-increasing requirement for fog range validation ([#10772](https://github.com/mapbox/mapbox-gl-js/pull/10772))
+
+## 13.20.0
+
+### ✨ Features and improvements
 
-* Added compatibility table for the `terrain` root level property in the style specification. ([#10619](https://github.com/mapbox/mapbox-gl-js/pull/10619))
+* Add configurable fog as a root style specification ([#10564](https://github.com/mapbox/mapbox-gl-js/pull/10564))
+* Add support for data-driven expressions in `line-dasharray` and `line-cap` properties. ([#10591](https://github.com/mapbox/mapbox-gl-js/pull/10591))
+* Add support for data-driven `text-line-height` ([#10612](https://github.com/mapbox/mapbox-gl-js/pull/10612))
 
 ## 13.19.0
 
@@ -12,7 +27,7 @@
 
 * Added array support to minimums and maximums, allowing for validation of multi-dimensional style-spec value constraints. ([#10272](https://github.com/mapbox/mapbox-gl-js/pull/10272))
 
-# 13.18.1
+## 13.18.1
 
 ### 🐞 Bug fixes
 * Fixed a bug where `map.setStyle` couldn't be used to enable terrain. ([#10177](https://github.com/mapbox/mapbox-gl-js/pull/10177))

package/diff.js

@@ -101,7 +101,12 @@ const operations = {
     /*
      * { command: 'setTerrain', args: [terrainProperties] }
      */
-    setTerrain: 'setTerrain'
+    setTerrain: 'setTerrain',
+
+    /*
+     *  { command: 'setFog', args: [fogProperties] }
+     */
+    setFog: 'setFog'
 
 };
 
@@ -355,6 +360,9 @@ function diffStyles(before, after) {
         if (!isEqual(before.light, after.light)) {
             commands.push({command: operations.setLight, args: [after.light]});
         }
+        if (!isEqual(before.fog, after.fog)) {
+            commands.push({command: operations.setFog, args: [after.fog]});
+        }
 
         // Handle changes to `sources`
         // If a source is to be removed, we also--before the removeSource

package/dist/{index.js → index.cjs}

@@ -66,6 +66,10 @@
   		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",
@@ -617,7 +621,9 @@
   				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"
   					}
   				}
   			}
@@ -713,7 +719,9 @@
   		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"
@@ -865,15 +873,19 @@
   				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",
@@ -1804,7 +1816,12 @@
   		units: "ems",
   		doc: "The maximum line width for text wrapping.",
   		requires: [
-  			"text-field"
+  			"text-field",
+  			{
+  				"symbol-placement": [
+  					"point"
+  				]
+  			}
   		],
   		"sdk-support": {
   			"basic functionality": {
@@ -1843,15 +1860,19 @@
   				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",
@@ -2119,20 +2140,15 @@
   		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": {
@@ -2610,7 +2626,7 @@
   			}
   		},
   		"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": {
@@ -2652,7 +2668,7 @@
   			}
   		},
   		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": {
@@ -2878,7 +2894,10 @@
   			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"
   				}
   			}
   		},
@@ -3024,7 +3043,7 @@
   			}
   		},
   		"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": {
@@ -3088,7 +3107,9 @@
   			group: "sky",
   			"sdk-support": {
   				"basic functionality": {
-  					js: "2.0.0"
+  					js: "2.0.0",
+  					ios: "10.0.0",
+  					android: "10.0.0"
   				}
   			}
   		},
@@ -3097,7 +3118,10 @@
   			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"
   				}
   			}
   		},
@@ -3592,6 +3616,75 @@
   		}
   	}
   };
+  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",
@@ -3707,7 +3800,9 @@
   		required: true,
   		"sdk-support": {
   			"basic functionality": {
-  				js: "2.0.0"
+  				js: "2.0.0",
+  				ios: "10.0.0",
+  				android: "10.0.0"
   			}
   		}
   	},
@@ -3727,7 +3822,9 @@
   		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"
   			}
   		}
   	}
@@ -4219,15 +4316,17 @@
   				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",
@@ -5648,7 +5747,9 @@
   		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: {
@@ -5676,7 +5777,9 @@
   		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: [
@@ -5706,7 +5809,9 @@
   		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"
@@ -5737,7 +5842,9 @@
   		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: {
@@ -5762,7 +5869,9 @@
   		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: {
@@ -5797,7 +5906,9 @@
   		],
   		"sdk-support": {
   			"basic functionality": {
-  				js: "2.0.0"
+  				js: "2.0.0",
+  				ios: "10.0.0",
+  				android: "10.0.0"
   			},
   			"data-driven styling": {
   			}
@@ -5822,7 +5933,9 @@
   		],
   		"sdk-support": {
   			"basic functionality": {
-  				js: "2.0.0"
+  				js: "2.0.0",
+  				ios: "10.0.0",
+  				android: "10.0.0"
   			}
   		},
   		"property-type": "data-constant"
@@ -5839,7 +5952,9 @@
   		],
   		"sdk-support": {
   			"basic functionality": {
-  				js: "2.0.0"
+  				js: "2.0.0",
+  				ios: "10.0.0",
+  				android: "10.0.0"
   			}
   		},
   		"property-type": "data-constant"
@@ -5853,7 +5968,9 @@
   		transition: true,
   		"sdk-support": {
   			"basic functionality": {
-  				js: "2.0.0"
+  				js: "2.0.0",
+  				ios: "10.0.0",
+  				android: "10.0.0"
   			}
   		},
   		expression: {
@@ -6001,6 +6118,7 @@
   	function_stop: function_stop,
   	expression: expression,
   	expression_name: expression_name,
+  	fog: fog,
   	light: light,
   	terrain: terrain,
   	paint: paint,
@@ -6221,6 +6339,7 @@
   		"sdk-support": {
   			"basic functionality": {
   				js: "0.50.0",
+  				android: "7.0.0",
   				ios: "4.7.0",
   				macos: "0.13.0"
   			}
@@ -12806,7 +12925,8 @@
       setGlyphs: 'setGlyphs',
       setTransition: 'setTransition',
       setLight: 'setLight',
-      setTerrain: 'setTerrain'
+      setTerrain: 'setTerrain',
+      setFog: 'setFog'
   };
   function addSource(sourceId, after, commands) {
       commands.push({
@@ -13107,6 +13227,12 @@
                   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);
@@ -14046,6 +14172,44 @@
       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 [];
@@ -14077,6 +14241,7 @@
       'source': validateSource,
       'light': validateLight,
       'terrain': validateTerrain,
+      'fog': validateFog,
       'string': validateString,
       'formatted': validateFormatted,
       'resolvedImage': validateImage
@@ -14140,6 +14305,7 @@
   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);
@@ -14860,6 +15026,11 @@
       });
       return errors;
   }
+  const acceptedSourceTypes = new Set([
+      'vector',
+      'raster',
+      'raster-dem'
+  ]);
   function getSourceErrors(source, i) {
       const errors = [];
       const sourceKeys = [
@@ -14868,9 +15039,12 @@
           '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;
   }
@@ -14981,4 +15155,4 @@
   Object.defineProperty(exports, '__esModule', { value: true });
 
 })));
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.cjs.map