@mapbox/mapbox-gl-style-spec 14.0.0-beta.2 → 14.0.0-beta.3

package/diff.js

@@ -2,7 +2,7 @@
 
 import isEqual from './util/deep_equal.js';
 
-import type {StyleSpecification, SourceSpecification, LayerSpecification} from './types.js';
+import type {StyleSpecification, ImportSpecification, SourceSpecification, LayerSpecification} from './types.js';
 
 type Sources = { [string]: SourceSpecification };
 
@@ -131,7 +131,17 @@ export const operations: {[_: string]: string} = {
     /*
      *  { command: 'setProjection', args: [projectionProperties] }
      */
-    setProjection: 'setProjection'
+    setProjection: 'setProjection',
+
+    /*
+     *  { command: 'addImport', args: [importProperties] }
+     */
+    addImport: 'addImport',
+
+    /*
+     *  { command: 'removeImport', args: [importId] }
+     */
+    removeImport: 'removeImport'
 };
 
 function addSource(sourceId: string, after: Sources, commands: Array<Command>) {
@@ -335,6 +345,17 @@ function diffLayers(before: Array<LayerSpecification>, after: Array<LayerSpecifi
     }
 }
 
+function diffImports(before: Array<ImportSpecification> = [], after: Array<ImportSpecification> = [], commands: Array<Command>) {
+    // no diff for the imports, must remove then add
+    for (const beforeImport of before) {
+        commands.push({command: operations.removeImport, args: [beforeImport.id]});
+    }
+
+    for (const afterImport of after) {
+        commands.push({command: operations.addImport, args: [afterImport]});
+    }
+}
+
 /**
  * Diff two stylesheet
  *
@@ -445,6 +466,8 @@ export default function diffStyles(before: StyleSpecification, after: StyleSpeci
         // Handle changes to `layers`
         diffLayers(beforeLayers, after.layers, commands);
 
+        // Handle changes to `imports`
+        diffImports(before.imports, after.imports, commands);
     } catch (e) {
         // fall back to setStyle
         console.warn('Unable to compute style diff:', e);

package/dist/index.cjs

@@ -1735,6 +1735,37 @@
   		},
   		"property-type": "data-constant"
   	},
+  	"symbol-z-elevate": {
+  		type: "boolean",
+  		"default": false,
+  		doc: "Position symbol on buildings (both fill extrusions and models) roof tops. In order to have minimal impact on performance, this is supported only when `fill-extrusion-height` is not zoom-dependent and not edited after initial bucket creation. For fading in buildings when zooming in, fill-extrusion-vertical-scale should be used and symbols would raise with building roofs. Symbols are sorted by elevation, except in case when `viewport-y` sorting or `symbol-sort-key` are applied.",
+  		"sdk-support": {
+  			"basic functionality": {
+  				js: "3.0.0",
+  				android: "11.0.0",
+  				ios: "11.0.0"
+  			}
+  		},
+  		requires: [
+  			{
+  				"symbol-placement": [
+  					"point"
+  				]
+  			},
+  			{
+  				"symbol-z-order": [
+  					"auto"
+  				]
+  			}
+  		],
+  		expression: {
+  			interpolated: false,
+  			parameters: [
+  				"zoom"
+  			]
+  		},
+  		"property-type": "data-constant"
+  	},
   	"icon-allow-overlap": {
   		type: "boolean",
   		"default": false,
@@ -4576,6 +4607,34 @@
   				ios: "10.6.0"
   			}
   		}
+  	},
+  	"vertical-range": {
+  		type: "array",
+  		"default": [
+  			0,
+  			0
+  		],
+  		minimum: 0,
+  		length: 2,
+  		value: "number",
+  		"property-type": "data-constant",
+  		transition: true,
+  		expression: {
+  			interpolated: true,
+  			parameters: [
+  				"zoom",
+  				"measure-light"
+  			],
+  			relaxZoomRestriction: true
+  		},
+  		doc: "Specify the vertical range, measured in meters, over which the fog should gradually fade out. When both parameters are set to zero, the fog will be rendered without any vertical constraints.",
+  		"sdk-support": {
+  			"basic functionality": {
+  				js: "3.0.0",
+  				android: "11.0.0",
+  				ios: "11.0.0"
+  			}
+  		}
   	}
   };
   var camera = {
@@ -5091,7 +5150,7 @@
   		minimum: 0,
   		transition: true,
   		units: "intensity",
-  		doc: "Emission strength",
+  		doc: "Controls the intensity of light emitted on the source features. This property works only with 3D light, i.e. when `lights` root property is defined.",
   		"sdk-support": {
   			"basic functionality": {
   				js: "3.0.0",
@@ -5423,7 +5482,28 @@
   	},
   	"line-gradient": {
   		type: "color",
-  		doc: "Defines a gradient with which to color a line feature. Can only be used with GeoJSON sources that specify `\"lineMetrics\": true`.",
+  		doc: "A gradient used to color a line feature at various distances along its length. Defined using a `step` or `interpolate` expression which outputs a color for each corresponding `line-progress` input value. `line-progress` is a percentage of the line feature's total length as measured on the webmercator projected coordinate plane (a `number` between `0` and `1`).  Can only be used with GeoJSON sources that specify `\"lineMetrics\": true`.",
+  		example: [
+  			"interpolate",
+  			[
+  				"linear"
+  			],
+  			[
+  				"line-progress"
+  			],
+  			0,
+  			"blue",
+  			0.1,
+  			"royalblue",
+  			0.3,
+  			"cyan",
+  			0.5,
+  			"lime",
+  			0.7,
+  			"yellow",
+  			1,
+  			"red"
+  		],
   		transition: false,
   		requires: [
   			{
@@ -5496,7 +5576,7 @@
   		minimum: 0,
   		transition: true,
   		units: "intensity",
-  		doc: "Emission strength",
+  		doc: "Controls the intensity of light emitted on the source features. This property works only with 3D light, i.e. when `lights` root property is defined.",
   		"sdk-support": {
   			"basic functionality": {
   				js: "3.0.0",
@@ -5910,7 +5990,7 @@
   		minimum: 0,
   		transition: true,
   		units: "intensity",
-  		doc: "Emission strength",
+  		doc: "Controls the intensity of light emitted on the source features. This property works only with 3D light, i.e. when `lights` root property is defined.",
   		"sdk-support": {
   			"basic functionality": {
   				js: "3.0.0",
@@ -6123,7 +6203,7 @@
   		minimum: 0,
   		transition: true,
   		units: "intensity",
-  		doc: "Emission strength",
+  		doc: "Controls the intensity of light emitted on the source features. This property works only with 3D light, i.e. when `lights` root property is defined.",
   		"sdk-support": {
   			"basic functionality": {
   				js: "3.0.0",
@@ -6151,7 +6231,7 @@
   		minimum: 0,
   		transition: true,
   		units: "intensity",
-  		doc: "Emission strength",
+  		doc: "Controls the intensity of light emitted on the source features. This property works only with 3D light, i.e. when `lights` root property is defined.",
   		"sdk-support": {
   			"basic functionality": {
   				js: "3.0.0",
@@ -6693,6 +6773,9 @@
   		value: "number",
   		"property-type": "data-constant",
   		transition: true,
+  		requires: [
+  			"raster-color"
+  		],
   		expression: {
   			interpolated: true,
   			parameters: [
@@ -6724,6 +6807,9 @@
   		value: "number",
   		"property-type": "data-constant",
   		transition: true,
+  		requires: [
+  			"raster-color"
+  		],
   		expression: {
   			interpolated: true,
   			parameters: [
@@ -7125,7 +7211,7 @@
   		minimum: 0,
   		transition: true,
   		units: "intensity",
-  		doc: "Emission strength",
+  		doc: "Controls the intensity of light emitted on the source features. This property works only with 3D light, i.e. when `lights` root property is defined.",
   		"sdk-support": {
   			"basic functionality": {
   				js: "3.0.0",
@@ -7740,6 +7826,25 @@
   			}
   		},
   		transition: true
+  	},
+  	"model-cutoff-fade-range": {
+  		type: "number",
+  		"default": 0,
+  		minimum: 0,
+  		maximum: 1,
+  		doc: "This parameter defines the range for the fade-out effect before an automatic content cutoff  on pitched map views. The automatic cutoff range is calculated according to the minimum required zoom level of the source and layer. The fade range is expressed in relation to the height of the map view. A value of 1.0 indicates that the content is faded to the same extent as the map's height in pixels, while a value close to zero represents a sharp cutoff. When the value is set to 0.0, the cutoff is completely disabled. Note: The property has no effect on the map if terrain is enabled.",
+  		transition: false,
+  		expression: {
+  			interpolated: false
+  		},
+  		"sdk-support": {
+  			"basic functionality": {
+  				js: "3.0.0",
+  				android: "11.0.0",
+  				ios: "11.0.0"
+  			}
+  		},
+  		"property-type": "data-constant"
   	}
   };
   var transition = {
@@ -8528,6 +8633,25 @@
   				"zoom"
   			]
   		}
+  	},
+  	"fill-extrusion-cutoff-fade-range": {
+  		type: "number",
+  		"default": 0,
+  		minimum: 0,
+  		maximum: 1,
+  		doc: "This parameter defines the range for the fade-out effect before an automatic content cutoff  on pitched map views. The automatic cutoff range is calculated according to the minimum required zoom level of the source and layer. The fade range is expressed in relation to the height of the map view. A value of 1.0 indicates that the content is faded to the same extent as the map's height in pixels, while a value close to zero represents a sharp cutoff. When the value is set to 0.0, the cutoff is completely disabled. Note: The property has no effect on the map if terrain is enabled.",
+  		transition: false,
+  		expression: {
+  			interpolated: false
+  		},
+  		"sdk-support": {
+  			"basic functionality": {
+  				js: "3.0.0",
+  				android: "11.0.0",
+  				ios: "11.0.0"
+  			}
+  		},
+  		"property-type": "data-constant"
   	}
   },
   	paint_line: paint_line,
@@ -18429,7 +18553,15 @@ ${ JSON.stringify(filterExp, null, 2) }
       /*
        *  { command: 'setProjection', args: [projectionProperties] }
        */
-      setProjection: 'setProjection'
+      setProjection: 'setProjection',
+      /*
+       *  { command: 'addImport', args: [importProperties] }
+       */
+      addImport: 'addImport',
+      /*
+       *  { command: 'removeImport', args: [importId] }
+       */
+      removeImport: 'removeImport'
   };
   function addSource(sourceId, after, commands) {
       commands.push({
@@ -18692,6 +18824,21 @@ ${ JSON.stringify(filterExp, null, 2) }
           }
       }
   }
+  function diffImports(before = [], after = [], commands) {
+      // no diff for the imports, must remove then add
+      for (const beforeImport of before) {
+          commands.push({
+              command: operations.removeImport,
+              args: [beforeImport.id]
+          });
+      }
+      for (const afterImport of after) {
+          commands.push({
+              command: operations.addImport,
+              args: [afterImport]
+          });
+      }
+  }
   /**
    * Diff two stylesheet
    *
@@ -18844,6 +18991,8 @@ ${ JSON.stringify(filterExp, null, 2) }
           }
           // Handle changes to `layers`
           diffLayers(beforeLayers, after.layers, commands);
+          // Handle changes to `imports`
+          diffImports(before.imports, after.imports, commands);
       } catch (e) {
           // fall back to setStyle
           console.warn('Unable to compute style diff:', e);