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

package/flow-typed/gl-matrix.js

@@ -53,7 +53,8 @@ declare module "gl-matrix" {
         scale<T: Vec4>(T, Vec4, number): T,
         mul<T: Vec4>(T, Vec4, Vec4): T,
         transformMat4<T: Vec4>(T, Vec4, Mat4): T,
-        normalize<T: Vec4>(T, Vec4): T
+        normalize<T: Vec4>(T, Vec4): T,
+        dot(Vec4, Vec4): number,
     };
 
     declare var mat2: {

package/flow-typed/gl.js

@@ -1,5 +1,5 @@
 // @flow strict
 declare module "gl" {
-    declare function gl(width: number, height: number, attributes: WebGLContextAttributes): WebGLRenderingContext;
+    declare function gl(width: number, height: number, attributes: WebGLContextAttributes): WebGL2RenderingContext;
     declare module.exports: typeof gl;
 }

package/flow-typed/webgl2.js

@@ -0,0 +1,20 @@
+// @flow strict
+
+type GLenum = number;
+type GLintptr = number;
+type GLsizei = number;
+type GLuint = number;
+
+declare interface WebGLVertexArrayObject {
+    prototype: WebGLVertexArrayObject;
+    new(): WebGLVertexArrayObject;
+}
+
+export type WebGL2RenderingContext = WebGLRenderingContext & {
+    createVertexArray: () => WebGLVertexArrayObject | null;
+    deleteVertexArray: (vertexArray: WebGLVertexArrayObject | null) => void;
+    bindVertexArray: (array: WebGLVertexArrayObject | null) => void;
+    getBufferSubData: (target: GLenum, srcByteOffset: GLintptr, dstBuffer: $ArrayBufferView, dstOffset?: GLuint, length?: GLuint) => void;
+    drawElementsInstanced: (mode: GLenum, count: GLsizei, type: GLenum, offset: GLintptr, instanceCount: GLsizei) => void;
+    vertexAttribDivisor: (index: GLuint, divisor: GLuint) => void;
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mapbox/mapbox-gl-style-spec",
   "description": "a specification for mapbox gl styles",
-  "version": "14.0.0-beta.2",
+  "version": "14.0.0-beta.3",
   "author": "Mapbox",
   "keywords": [
     "mapbox",

package/reference/v8.json

@@ -1833,6 +1833,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,
@@ -4734,6 +4765,31 @@
           "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"
+        }
+      }
     }
   },
   "camera": {
@@ -5237,7 +5293,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",
@@ -5767,6 +5823,25 @@
           "zoom"
         ]
       }
+    },
+    "fill-extrusion-cutoff-fade-range": {
+      "type": "number",
+      "default": 0.0,
+      "minimum": 0.0,
+      "maximum": 1.0,
+      "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": {
@@ -6083,7 +6158,24 @@
     },
     "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": [
         {
@@ -6146,7 +6238,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",
@@ -6560,7 +6652,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",
@@ -6772,7 +6864,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",
@@ -6800,7 +6892,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",
@@ -7341,6 +7433,9 @@
       "value": "number",
       "property-type": "data-constant",
       "transition": true,
+      "requires": [
+        "raster-color"
+      ],
       "expression": {
         "interpolated": true,
         "parameters": [
@@ -7372,6 +7467,9 @@
       "value": "number",
       "property-type": "data-constant",
       "transition": true,
+      "requires": [
+        "raster-color"
+      ],
       "expression": {
         "interpolated": true,
         "parameters": [
@@ -7773,7 +7871,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",
@@ -8330,6 +8428,25 @@
         }
       },
       "transition": true
+    },
+    "model-cutoff-fade-range": {
+      "type": "number",
+      "default": 0.0,
+      "minimum": 0.0,
+      "maximum": 1.0,
+      "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"
     }
   },
   "transition": {

package/types.js

@@ -108,7 +108,8 @@ export type FogSpecification = {|
     "high-color"?: PropertyValueSpecification<ColorSpecification>,
     "space-color"?: PropertyValueSpecification<ColorSpecification>,
     "horizon-blend"?: PropertyValueSpecification<number>,
-    "star-intensity"?: PropertyValueSpecification<number>
+    "star-intensity"?: PropertyValueSpecification<number>,
+    "vertical-range"?: PropertyValueSpecification<[number, number]>
 |}
 
 export type CameraSpecification = {|
@@ -353,6 +354,7 @@ export type SymbolLayerSpecification = {|
         "symbol-avoid-edges"?: PropertyValueSpecification<boolean>,
         "symbol-sort-key"?: DataDrivenPropertyValueSpecification<number>,
         "symbol-z-order"?: PropertyValueSpecification<"auto" | "viewport-y" | "source">,
+        "symbol-z-elevate"?: PropertyValueSpecification<boolean>,
         "icon-allow-overlap"?: PropertyValueSpecification<boolean>,
         "icon-ignore-placement"?: PropertyValueSpecification<boolean>,
         "icon-optional"?: PropertyValueSpecification<boolean>,
@@ -498,7 +500,8 @@ export type FillExtrusionLayerSpecification = {|
         "fill-extrusion-flood-light-ground-radius"?: DataDrivenPropertyValueSpecification<number>,
         "fill-extrusion-flood-light-ground-attenuation"?: PropertyValueSpecification<number>,
         "fill-extrusion-vertical-scale"?: PropertyValueSpecification<number>,
-        "fill-extrusion-rounded-roof"?: PropertyValueSpecification<boolean>
+        "fill-extrusion-rounded-roof"?: PropertyValueSpecification<boolean>,
+        "fill-extrusion-cutoff-fade-range"?: ExpressionSpecification
     |}
 |}
 
@@ -580,7 +583,8 @@ export type ModelLayerSpecification = {|
         "model-ambient-occlusion-intensity"?: PropertyValueSpecification<number>,
         "model-emissive-strength"?: DataDrivenPropertyValueSpecification<number>,
         "model-roughness"?: DataDrivenPropertyValueSpecification<number>,
-        "model-height-based-emissive-strength-multiplier"?: DataDrivenPropertyValueSpecification<[number, number, number, number, number]>
+        "model-height-based-emissive-strength-multiplier"?: DataDrivenPropertyValueSpecification<[number, number, number, number, number]>,
+        "model-cutoff-fade-range"?: ExpressionSpecification
     |}
 |}