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

package/flow-typed/gl-matrix.js

@@ -55,6 +55,8 @@ declare module "gl-matrix" {
         transformMat4<T: Vec4>(T, Vec4, Mat4): T,
         normalize<T: Vec4>(T, Vec4): T,
         dot(Vec4, Vec4): number,
+        min<T: Vec4>(T, Vec4, Vec4): T,
+        max<T: Vec4>(T, Vec4, Vec4): T,
     };
 
     declare var mat2: {
@@ -82,6 +84,7 @@ declare module "gl-matrix" {
         fromScaling<T: Mat4>(T, Vec3): T,
         fromTranslation<T: Mat4>(T, Vec3): T,
         fromQuat<T: Mat4>(T, Quat): T,
+        fromRotationTranslationScale<T: Mat4>(T, Quat, Vec3, Vec3): T,
         ortho<T: Mat4>(T, number, number, number, number, number, number): T,
         perspective<T: Mat4>(T, number, number, number, number): T,
         identity<T: Mat4>(T): T,

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.3",
+  "version": "14.0.0-beta.4",
   "author": "Mapbox",
   "keywords": [
     "mapbox",

package/reference/v8.json

@@ -27,7 +27,7 @@
     "center": {
       "type": "array",
       "value": "number",
-      "doc": "Default map center in longitude and latitude.  The style center will be used only if the map has not been positioned by other means (e.g. map options or user interaction).",
+      "doc": "Default map center in longitude and latitude. The style center will be used only if the map has not been positioned by other means (e.g. map options or user interaction).",
       "example": [
         -73.9749,
         40.7736
@@ -35,7 +35,7 @@
     },
     "zoom": {
       "type": "number",
-      "doc": "Default zoom level.  The style zoom will be used only if the map has not been positioned by other means (e.g. map options or user interaction).",
+      "doc": "Default zoom level. The style zoom will be used only if the map has not been positioned by other means (e.g. map options or user interaction).",
       "example": 12.5
     },
     "bearing": {
@@ -924,13 +924,13 @@
       "doc": "The data type of the image source."
     },
     "url": {
-      "required": true,
+      "required": false,
       "type": "string",
-      "doc": "URL that points to an image."
+      "doc": "URL that points to an image. If the URL is not specified, the image is expected to be loaded directly during runtime."
     },
     "coordinates": {
       "required": true,
-      "doc": "Corners of image specified in longitude, latitude pairs.",
+      "doc": "Corners of image specified in longitude, latitude pairs. Note: When using globe projection, the image will be centered at the North or South Pole in the respective hemisphere if the average latitude value exceeds 85 degrees or falls below -85 degrees.",
       "type": "array",
       "length": 4,
       "value": {
@@ -1152,7 +1152,7 @@
     },
     "filter": {
       "type": "filter",
-      "doc": "An expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The `[\"feature-state\", ...]` expression is not supported in filter expressions.  The `[\"pitch\"]` and `[\"distance-from-center\"]` expressions are supported only for filter expressions on the symbol layer."
+      "doc": "An expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The `[\"feature-state\", ...]` expression is not supported in filter expressions. The `[\"pitch\"]` and `[\"distance-from-center\"]` expressions are supported only for filter expressions on the symbol layer."
     },
     "layout": {
       "type": "layout",
@@ -1778,7 +1778,7 @@
     },
     "symbol-sort-key": {
       "type": "number",
-      "doc": "Sorts features in ascending order based on this value. Features with lower sort keys are drawn and placed first.  When `icon-allow-overlap` or `text-allow-overlap` is `false`, features with a lower sort key will have priority during placement. When `icon-allow-overlap` or `text-allow-overlap` is set to `true`, features with a higher sort key will overlap over features with a lower sort key.",
+      "doc": "Sorts features in ascending order based on this value. Features with lower sort keys are drawn and placed first. When `icon-allow-overlap` or `text-allow-overlap` is `false`, features with a lower sort key will have priority during placement. When `icon-allow-overlap` or `text-allow-overlap` is set to `true`, features with a higher sort key will overlap over features with a lower sort key.",
       "sdk-support": {
         "basic functionality": {
           "js": "0.53.0",
@@ -3478,7 +3478,7 @@
         }
       },
       "array": {
-        "doc": "Asserts that the input is an array (optionally with a specific item type and length).  If, when the input expression is evaluated, it is not of the asserted type, then this assertion will cause the whole expression to be aborted.",
+        "doc": "Asserts that the input is an array (optionally with a specific item type and length). If, when the input expression is evaluated, it is not of the asserted type, then this assertion will cause the whole expression to be aborted.",
         "group": "Types",
         "sdk-support": {
           "basic functionality": {
@@ -3924,7 +3924,7 @@
         }
       },
       "properties": {
-        "doc": "Returns the feature properties object.  Note that in some cases, it may be more efficient to use `[\"get\", \"property_name\"]` directly.",
+        "doc": "Returns the feature properties object. Note that in some cases, it may be more efficient to use `[\"get\", \"property_name\"]` directly.",
         "group": "Feature data",
         "sdk-support": {
           "basic functionality": {
@@ -3971,7 +3971,7 @@
         }
       },
       "zoom": {
-        "doc": "Returns the current zoom level.  Note that in style layout and paint properties, [\"zoom\"] may only appear as the input to a top-level \"step\" or \"interpolate\" expression.",
+        "doc": "Returns the current zoom level. Note that in style layout and paint properties, [\"zoom\"] may only appear as the input to a top-level \"step\" or \"interpolate\" expression.",
         "group": "Camera",
         "sdk-support": {
           "basic functionality": {
@@ -4782,7 +4782,7 @@
         ],
         "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.",
+      "doc": "An array of two number values, specifying 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",
@@ -5005,7 +5005,7 @@
       "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).",
+      "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": [
         29.5,
         45.5
@@ -5481,8 +5481,7 @@
         "parameters": [
           "zoom",
           "feature",
-          "feature-state",
-          "measure-light"
+          "feature-state"
         ]
       },
       "property-type": "data-driven"
@@ -5516,8 +5515,7 @@
         "parameters": [
           "zoom",
           "feature",
-          "feature-state",
-          "measure-light"
+          "feature-state"
         ]
       },
       "property-type": "data-driven"
@@ -5829,7 +5827,7 @@
       "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.",
+      "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
@@ -6158,7 +6156,7 @@
     },
     "line-gradient": {
       "type": "color",
-      "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`.",
+      "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" ],
@@ -6779,7 +6777,7 @@
         1,
         "red"
       ],
-      "doc": "Defines the color of each pixel based on its density value in a heatmap.  Should be an expression that uses `[\"heatmap-density\"]` as input.",
+      "doc": "Defines the color of each pixel based on its density value in a heatmap. Should be an expression that uses `[\"heatmap-density\"]` as input.",
       "transition": false,
       "sdk-support": {
         "basic functionality": {
@@ -7403,7 +7401,7 @@
     },
     "raster-color": {
       "type": "color",
-      "doc": "Defines a color map by which to colorize a raster layer, parameterized by the `[\"raster-value\"]` expression and evaluated at 1024 uniformly spaced steps over the range specified by `raster-color-range`.",
+      "doc": "Defines a color map by which to colorize a raster layer, parameterized by the `[\"raster-value\"]` expression and evaluated at 256 uniformly spaced steps over the range specified by `raster-color-range`.",
       "transition": false,
       "sdk-support": {
         "basic functionality": {
@@ -7747,7 +7745,8 @@
       "expression": {
         "interpolated": true,
         "parameters": [
-          "zoom"
+          "zoom",
+          "measure-light"
         ]
       },
       "property-type": "data-constant"
@@ -7768,7 +7767,8 @@
       "expression": {
         "interpolated": true,
         "parameters": [
-          "zoom"
+          "zoom",
+          "measure-light"
         ]
       },
       "property-type": "data-constant"
@@ -7789,7 +7789,31 @@
       "expression": {
         "interpolated": true,
         "parameters": [
-          "zoom"
+          "zoom",
+          "measure-light"
+        ]
+      },
+      "property-type": "data-constant"
+    },
+    "hillshade-emissive-strength": {
+      "type": "number",
+      "default": 0.0,
+      "minimum": 0,
+      "transition": true,
+      "units": "intensity",
+      "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",
+          "android": "11.0.0",
+          "ios": "11.0.0"
+        }
+      },
+      "expression": {
+        "interpolated": true,
+        "parameters": [
+          "zoom",
+          "measure-light"
         ]
       },
       "property-type": "data-constant"
@@ -8434,7 +8458,7 @@
       "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.",
+      "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

package/types.js

@@ -216,7 +216,7 @@ export type VideoSourceSpecification = {|
 
 export type ImageSourceSpecification = {|
     "type": "image",
-    "url": string,
+    "url"?: string,
     "coordinates": [[number, number], [number, number], [number, number], [number, number]]
 |}
 
@@ -552,7 +552,8 @@ export type HillshadeLayerSpecification = {|
         "hillshade-exaggeration"?: PropertyValueSpecification<number>,
         "hillshade-shadow-color"?: PropertyValueSpecification<ColorSpecification>,
         "hillshade-highlight-color"?: PropertyValueSpecification<ColorSpecification>,
-        "hillshade-accent-color"?: PropertyValueSpecification<ColorSpecification>
+        "hillshade-accent-color"?: PropertyValueSpecification<ColorSpecification>,
+        "hillshade-emissive-strength"?: PropertyValueSpecification<number>
     |}
 |}