@mapbox/mapbox-gl-style-spec 13.25.0-beta.1 → 13.26.0

package/CHANGELOG.md

@@ -1,4 +1,13 @@
-## 13.25.0-beta.1
+## 13.26.0
+
+### Features ✨
+
+* Add unit option to number-format expression ([#11839](https://github.com/mapbox/mapbox-gl-js/pull/11839)) (h/t [varna](https://github.com/varna))
+
+## Bug fixes 🐞
+* Fix a bug where `id` expression didn't correctly handle a value of 0 ([#12000](https://github.com/mapbox/mapbox-gl-js/pull/12000))
+
+## 13.25.0
 
 ### Features ✨
 

package/dist/index.cjs

@@ -101,7 +101,7 @@
   	},
   	projection: {
   		type: "projection",
-  		doc: "The projection the map should be rendered in. Supported projections are Albers, Equal Earth, Equirectangular (WGS84), Lambert conformal conic, Mercator, Natural Earth, Globe, and Winkel Tripel. Terrain, fog, sky and CustomLayerInterface are not supported for projections other than mercator.",
+  		doc: "The projection the map should be rendered in. Supported projections are Mercator, Globe, Albers, Equal Earth, Equirectangular (WGS84), Lambert conformal conic, Natural Earth, and Winkel Tripel. Terrain, sky and fog are supported by only Mercator and globe. CustomLayerInterface is not supported outside of Mercator.",
   		example: {
   			name: "albers",
   			center: [
@@ -2977,7 +2977,7 @@
   			}
   		},
   		"number-format": {
-  			doc: "Converts the input number into a string representation using the providing formatting rules. If set, the `locale` argument specifies the locale to use, as a BCP 47 language tag. If set, the `currency` argument specifies an ISO 4217 code to use for currency-style formatting. If set, the `min-fraction-digits` and `max-fraction-digits` arguments specify the minimum and maximum number of fractional digits to include.",
+  			doc: "Converts the input number into a string representation using the providing formatting rules. If set, the `locale` argument specifies the locale to use, as a BCP 47 language tag. If set, the `currency` argument specifies an ISO 4217 code to use for currency-style formatting. If set, the `unit` argument specifies a [simple ECMAScript unit](https://tc39.es/proposal-unified-intl-numberformat/section6/locales-currencies-tz_proposed_out.html#sec-issanctionedsimpleunitidentifier) to use for unit-style formatting. If set, the `min-fraction-digits` and `max-fraction-digits` arguments specify the minimum and maximum number of fractional digits to include.",
   			group: "Types",
   			"sdk-support": {
   				"basic functionality": {
@@ -3667,7 +3667,9 @@
   			"sdk-support": {
   				"basic functionality": {
   					js: "0.45.0",
-  					android: "6.6.0"
+  					android: "6.6.0",
+  					ios: "4.1.0",
+  					macos: "0.8.0"
   				}
   			}
   		},
@@ -4045,6 +4047,14 @@
   		length: 2,
   		value: "number",
   		"property-type": "data-constant",
+  		minimum: [
+  			-180,
+  			-90
+  		],
+  		maximum: [
+  			180,
+  			90
+  		],
   		transition: false,
   		doc: "The reference longitude and latitude of the projection. `center` takes the form of [lng, lat]. This property is only configurable for conic projections (Albers and Lambert Conformal Conic). All other projections are centered on [0, 0].",
   		example: [
@@ -4070,6 +4080,14 @@
   		length: 2,
   		value: "number",
   		"property-type": "data-constant",
+  		minimum: [
+  			-90,
+  			-90
+  		],
+  		maximum: [
+  			90,
+  			90
+  		],
   		transition: false,
   		doc: "The standard parallels of the projection, denoting the desired latitude range with minimal distortion. `parallels` takes the form of [lat0, lat1]. This property is only configurable for conic projections (Albers and Lambert Conformal Conic).",
   		example: [
@@ -4692,15 +4710,22 @@
   	"line-trim-offset": {
   		type: "array",
   		value: "number",
-  		doc: "The line part between [trim-start, trim-end] will be marked as transparent to make a route vanishing effect. The line trim-off offset is based on the whole line gradient range [0.0, 1.0]. If either 'trim-start' or 'trim-end' offset is out of valid range, the default range will be set.",
+  		doc: "The line part between [trim-start, trim-end] will be marked as transparent to make a route vanishing effect. The line trim-off offset is based on the whole line range [0.0, 1.0].",
   		length: 2,
   		"default": [
   			0,
   			0
   		],
+  		minimum: [
+  			0,
+  			0
+  		],
+  		maximum: [
+  			1,
+  			1
+  		],
   		transition: false,
   		requires: [
-  			"line-gradient",
   			{
   				source: "geojson",
   				has: {
@@ -4710,7 +4735,7 @@
   		],
   		"sdk-support": {
   			"basic functionality": {
-  				js: "2.3.0",
+  				js: "2.9.0",
   				android: "10.5.0",
   				ios: "10.5.0",
   				macos: "10.5.0"
@@ -6371,6 +6396,20 @@
   			}
   		},
   		"property-type": "constant"
+  	},
+  	"fill-extrusion-edge-radius": {
+  		type: "number",
+  		"private": true,
+  		"default": 0,
+  		minimum: 0,
+  		maximum: 1,
+  		doc: "Radius of a fill extrusion edge in meters. If not zero, rounds extrusion edges for a smoother appearance.",
+  		"sdk-support": {
+  			"basic functionality": {
+  				js: "v2.10.0"
+  			}
+  		},
+  		"property-type": "constant"
   	}
   },
   	layout_line: layout_line,
@@ -6698,6 +6737,51 @@
   			]
   		},
   		"property-type": "data-constant"
+  	},
+  	"fill-extrusion-ambient-occlusion-intensity": {
+  		"property-type": "data-constant",
+  		type: "number",
+  		"private": true,
+  		"default": 0,
+  		minimum: 0,
+  		maximum: 1,
+  		expression: {
+  			interpolated: true,
+  			parameters: [
+  				"zoom"
+  			]
+  		},
+  		transition: true,
+  		doc: "Controls the intensity of ambient occlusion (AO) shading. Current AO implementation is a low-cost best-effort approach that shades area near ground and concave angles between walls. Default value 0.0 disables ambient occlusion and values around 0.3 provide the most plausible results for buildings.",
+  		"sdk-support": {
+  			"basic functionality": {
+  				js: "2.10.0",
+  				android: "10.7.0",
+  				ios: "10.7.0"
+  			}
+  		}
+  	},
+  	"fill-extrusion-ambient-occlusion-radius": {
+  		"property-type": "data-constant",
+  		type: "number",
+  		"private": true,
+  		"default": 3,
+  		minimum: 0,
+  		expression: {
+  			interpolated: true,
+  			parameters: [
+  				"zoom"
+  			]
+  		},
+  		transition: true,
+  		doc: "The radius of ambient occlusion (AO) shading, in meters. Current AO implementation is a low-cost best-effort approach that shades area near ground and concave angles between walls where the radius defines only vertical impact. Default value 3.0 corresponds to hight of one floor and brings the most plausible results for buildings.",
+  		"sdk-support": {
+  			"basic functionality": {
+  				js: "2.10.0",
+  				android: "10.7.0",
+  				ios: "10.7.0"
+  			}
+  		}
   	}
   },
   	paint_line: paint_line,
@@ -9446,7 +9530,7 @@
           this.featureDistanceData = null;
       }
       id() {
-          return this.feature && 'id' in this.feature && this.feature.id ? this.feature.id : null;
+          return this.feature && this.feature.id !== undefined ? this.feature.id : null;
       }
       geometryType() {
           return this.feature ? typeof this.feature.type === 'number' ? geometryTypes[this.feature.type] : this.feature.type : null;
@@ -11380,11 +11464,12 @@
   const GreaterThanOrEqual = makeComparison('>=', gteq, gteqCollate);
 
   class NumberFormat {
-      constructor(number, locale, currency, minFractionDigits, maxFractionDigits) {
+      constructor(number, locale, currency, unit, minFractionDigits, maxFractionDigits) {
           this.type = StringType;
           this.number = number;
           this.locale = locale;
           this.currency = currency;
+          this.unit = unit;
           this.minFractionDigits = minFractionDigits;
           this.maxFractionDigits = maxFractionDigits;
       }
@@ -11409,6 +11494,12 @@
               if (!currency)
                   return null;
           }
+          let unit = null;
+          if (options['unit']) {
+              unit = context.parse(options['unit'], 1, StringType);
+              if (!unit)
+                  return null;
+          }
           let minFractionDigits = null;
           if (options['min-fraction-digits']) {
               minFractionDigits = context.parse(options['min-fraction-digits'], 1, NumberType);
@@ -11421,12 +11512,13 @@
               if (!maxFractionDigits)
                   return null;
           }
-          return new NumberFormat(number, locale, currency, minFractionDigits, maxFractionDigits);
+          return new NumberFormat(number, locale, currency, unit, minFractionDigits, maxFractionDigits);
       }
       evaluate(ctx) {
           return new Intl.NumberFormat(this.locale ? this.locale.evaluate(ctx) : [], {
-              style: this.currency ? 'currency' : 'decimal',
+              style: this.currency && 'currency' || this.unit && 'unit' || 'decimal',
               currency: this.currency ? this.currency.evaluate(ctx) : undefined,
+              unit: this.unit ? this.unit.evaluate(ctx) : undefined,
               minimumFractionDigits: this.minFractionDigits ? this.minFractionDigits.evaluate(ctx) : undefined,
               maximumFractionDigits: this.maxFractionDigits ? this.maxFractionDigits.evaluate(ctx) : undefined
           }).format(this.number.evaluate(ctx));
@@ -11439,6 +11531,9 @@
           if (this.currency) {
               fn(this.currency);
           }
+          if (this.unit) {
+              fn(this.unit);
+          }
           if (this.minFractionDigits) {
               fn(this.minFractionDigits);
           }
@@ -11457,6 +11552,9 @@
           if (this.currency) {
               options['currency'] = this.currency.serialize();
           }
+          if (this.unit) {
+              options['unit'] = this.unit.serialize();
+          }
           if (this.minFractionDigits) {
               options['min-fraction-digits'] = this.minFractionDigits.serialize();
           }
@@ -14481,10 +14579,8 @@ ${ JSON.stringify(filterExp, null, 2) }
                   errors.push(new ValidationError(key, layer, `layer "${ layer.id }" must specify a "source-layer"`));
               } else if (sourceType === 'raster-dem' && type !== 'hillshade') {
                   errors.push(new ValidationError(key, layer.source, 'raster-dem source can only be used with layer type \'hillshade\'.'));
-              } else if (type === 'line' && layer.paint && layer.paint['line-gradient'] && (sourceType !== 'geojson' || !source.lineMetrics)) {
+              } else if (type === 'line' && layer.paint && (layer.paint['line-gradient'] || layer.paint['line-trim-offset']) && (sourceType !== 'geojson' || !source.lineMetrics)) {
                   errors.push(new ValidationError(key, layer, `layer "${ layer.id }" specifies a line-gradient, which requires a GeoJSON source with \`lineMetrics\` enabled.`));
-              } else if (type === 'line' && layer.paint && layer.paint['line-trim-offset'] && !layer.paint['line-gradient']) {
-                  errors.push(new ValidationError(key, layer, `layer "${ layer.id }" specifies a line-trim-offset, which requires line-gradient enabled.`));
               }
           }
       }