@mapbox/mapbox-gl-style-spec 14.0.0-rc.2 → 14.1.0-beta.1

package/package.json

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

package/reference/v8.json

@@ -87,7 +87,15 @@
             "shadow-intensity": 0.2
           }
         }
-      ]
+      ],
+      "sdk-support": {
+        "basic functionality": {
+          "js": "3.0.0",
+          "android": "11.0.0",
+          "ios": "11.0.0",
+          "macos": "11.0.0"
+        }
+      }
     },
     "terrain": {
       "type": "terrain",
@@ -310,7 +318,7 @@
           }
         },
         "directional": {
-          "doc": "A light that has a direction and is located at infinite, so its rays are parallel. Simulates the sun light and it can cast shadows",
+          "doc": "A light that has a direction and is located at infinite distance, so its rays are parallel. It simulates the sun light and can cast shadows.",
           "sdk-support": {
             "basic functionality": {
               "js": "3.0.0",
@@ -320,7 +328,7 @@
           }
         },
         "flat": {
-          "doc": "A global directional light source which is only applied on 3D layers and hillshade layers. Using this type disables other light sources.",
+          "doc": "A global directional light source which is only applied on 3D and hillshade layers. Using this type disables other light sources.",
           "sdk-support": {
             "basic functionality": {
               "js": "3.0.0",
@@ -603,6 +611,7 @@
     "source_vector",
     "source_raster",
     "source_raster_dem",
+    "source_raster_array",
     "source_geojson",
     "source_video",
     "source_image",
@@ -849,6 +858,67 @@
       "doc": "Other keys to configure the data source."
     }
   },
+  "source_raster_array": {
+    "type": {
+      "required": true,
+      "type": "enum",
+      "values": {
+        "raster-array": {
+          "doc": "A raster array source"
+        }
+      },
+      "doc": "The type of the source."
+    },
+    "url": {
+      "type": "string",
+      "doc": "A URL to a TileJSON resource. Supported protocols are `http:`, `https:`, and `mapbox://<Tileset ID>`."
+    },
+    "tiles": {
+      "type": "array",
+      "value": "string",
+      "doc": "An array of one or more tile source URLs, as in the TileJSON spec."
+    },
+    "bounds": {
+      "type": "array",
+      "value": "number",
+      "length": 4,
+      "default": [
+        -180,
+        -85.051129,
+        180,
+        85.051129
+      ],
+      "doc": "An array containing the longitude and latitude of the southwest and northeast corners of the source's bounding box in the following order: `[sw.lng, sw.lat, ne.lng, ne.lat]`. When this property is included in a source, no tiles outside of the given bounds are requested by Mapbox GL."
+    },
+    "minzoom": {
+      "type": "number",
+      "default": 0,
+      "doc": "Minimum zoom level for which tiles are available, as in the TileJSON spec."
+    },
+    "maxzoom": {
+      "type": "number",
+      "default": 22,
+      "doc": "Maximum zoom level for which tiles are available, as in the TileJSON spec. Data from tiles at the maxzoom are used when displaying the map at higher zoom levels."
+    },
+    "tileSize": {
+      "type": "number",
+      "default": 512,
+      "units": "pixels",
+      "doc": "The minimum visual size to display tiles for this layer. Only configurable for raster layers."
+    },
+    "attribution": {
+      "type": "string",
+      "doc": "Contains an attribution to be displayed when the map is shown to a user."
+    },
+    "rasterLayers": {
+      "type": "*",
+      "doc": "Contains the description of the raster data layers and the bands contained within the tiles."
+    },
+    "*": {
+      "type": "*",
+      "doc": "Other keys to configure the data source."
+    }
+  },
   "source_geojson": {
     "type": {
       "required": true,
@@ -1882,7 +1952,7 @@
     "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.",
+      "doc": "Position symbol on buildings (both fill extrusions and models) rooftops. In order to have minimal impact on performance, this is supported only when `fill-extrusion-height` is not zoom-dependent and remains unchanged. For fading in buildings when zooming in, fill-extrusion-vertical-scale should be used and symbols would raise with building rooftops. Symbols are sorted by elevation, except in cases when `viewport-y` sorting or `symbol-sort-key` are applied.",
       "sdk-support": {
         "basic functionality": {
           "js": "3.0.0",
@@ -5632,7 +5702,7 @@
         ]
       },
       "transition": true,
-      "doc": "Shades area near ground and concave angles between walls where the radius defines only vertical impact. Default value 3.0 corresponds to height of one floor and brings the most plausible results for buildings. This property works only with legacy light. When 3D light is enabled `fill-extrusion-ambient-occlusion-wall-radius` and `fill-extrusion-ambient-occlusion-ground-radius` are used instead.",
+      "doc": "Shades area near ground and concave angles between walls where the radius defines only vertical impact. Default value 3.0 corresponds to height of one floor and brings the most plausible results for buildings. This property works only with legacy light. When 3D lights are enabled `fill-extrusion-ambient-occlusion-wall-radius` and `fill-extrusion-ambient-occlusion-ground-radius` are used instead.",
       "requires": [
         "fill-extrusion-edge-radius",
         {
@@ -5944,7 +6014,33 @@
         }
       },
       "property-type": "data-constant"
-    }
+    },
+    "fill-extrusion-emissive-strength": {
+      "type": "number",
+      "default": 0,
+      "minimum": 0,
+      "transition": true,
+      "units": "intensity",
+      "doc": "Controls the intensity of light emitted on the source features.",
+      "requires": [
+        "lights"
+      ],
+      "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"
+   }
   },
   "paint_line": {
     "line-opacity": {
@@ -7768,6 +7864,66 @@
         ]
       },
       "property-type": "data-constant"
+    },
+    "raster-emissive-strength": {
+      "type": "number",
+      "default": 0,
+      "minimum": 0,
+      "transition": true,
+      "units": "intensity",
+      "doc": "Controls the intensity of light emitted on the source features.",
+      "requires": [
+        "lights"
+      ],
+      "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"
+   },
+    "raster-array-band": {
+      "type": "string",
+      "required": false,
+      "property-type": "data-constant",
+      "transition": false,
+      "doc": "Displayed band of raster array source layer",
+      "example": "band-name",
+      "sdk-support": {
+        "basic functionality": {
+          "js": "3.1.0",
+          "android": "11.1.0",
+          "ios": "11.1.0"
+        }
+      }
+    },
+    "raster-elevation": {
+      "type": "number",
+      "doc": "Specifies an uniform elevation from the ground, in meters. Only supported with image sources.",
+      "default": 0,
+      "minimum": 0,
+      "transition": true,
+      "sdk-support": {
+        "basic functionality": {
+          "js": "3.1.0"
+        }
+      },
+      "expression": {
+        "interpolated": true,
+        "parameters": [
+          "zoom"
+        ]
+      },
+      "property-type": "data-constant"
     }
   },
   "paint_hillshade": {
@@ -7917,7 +8073,10 @@
       "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.",
+      "doc": "Controls the intensity of light emitted on the source features.",
+      "requires": [
+        "lights"
+      ],
       "sdk-support": {
         "basic functionality": {
           "js": "3.0.0",

package/types.js

@@ -501,7 +501,8 @@ export type FillExtrusionLayerSpecification = {|
         "fill-extrusion-flood-light-ground-attenuation"?: PropertyValueSpecification<number>,
         "fill-extrusion-vertical-scale"?: PropertyValueSpecification<number>,
         "fill-extrusion-rounded-roof"?: PropertyValueSpecification<boolean>,
-        "fill-extrusion-cutoff-fade-range"?: ExpressionSpecification
+        "fill-extrusion-cutoff-fade-range"?: ExpressionSpecification,
+        "fill-extrusion-emissive-strength"?: PropertyValueSpecification<number>
     |}
 |}
 
@@ -529,7 +530,10 @@ export type RasterLayerSpecification = {|
         "raster-saturation"?: PropertyValueSpecification<number>,
         "raster-contrast"?: PropertyValueSpecification<number>,
         "raster-resampling"?: PropertyValueSpecification<"linear" | "nearest">,
-        "raster-fade-duration"?: PropertyValueSpecification<number>
+        "raster-fade-duration"?: PropertyValueSpecification<number>,
+        "raster-emissive-strength"?: PropertyValueSpecification<number>,
+        "raster-array-band"?: string,
+        "raster-elevation"?: PropertyValueSpecification<number>
     |}
 |}