mapbox-gl 1.13.2

package/src/style-spec/rollup.config.js

@@ -0,0 +1,65 @@
+import path from 'path';
+import replace from 'rollup-plugin-replace';
+import buble from 'rollup-plugin-buble';
+import resolve from 'rollup-plugin-node-resolve';
+import commonjs from 'rollup-plugin-commonjs';
+import unassert from 'rollup-plugin-unassert';
+import json from 'rollup-plugin-json';
+import {flow} from '../../build/rollup_plugins';
+
+// Build es modules?
+const esm = 'esm' in process.env;
+
+const transforms = {
+    dangerousForOf: true,
+    modules: esm ? false : undefined
+};
+
+const ROOT_DIR = __dirname;
+
+const config = [{
+    input: `${__dirname}/style-spec.js`,
+    output: {
+        name: 'mapboxGlStyleSpecification',
+        file: `${__dirname}/dist/${esm ? 'index.es.js' : 'index.js'}`,
+        format: esm ? 'esm' : 'umd',
+        sourcemap: true
+    },
+    plugins: [
+        {
+            name: 'dep-checker',
+            resolveId(source, importer) {
+                // Some users reference modules within style-spec package directly, instead of the bundle
+                // This means that files within the style-spec package should NOT import files from the parent mapbox-gl-js tree.
+                // This check will cause the build to fail on CI allowing these issues to be caught.
+                if (importer && !importer.includes('node_modules')) {
+                    const resolvedPath = path.join(importer, source);
+                    const fromRoot = path.relative(ROOT_DIR, resolvedPath);
+                    if (fromRoot.length > 2 && fromRoot.slice(0, 2) === '..') {
+                        throw new Error(`Module ${importer} imports ${source} from outside the style-spec package root directory.`);
+                    }
+                }
+
+                return null;
+            }
+        },
+        // https://github.com/zaach/jison/issues/351
+        replace({
+            include: /\/jsonlint-lines-primitives\/lib\/jsonlint.js/,
+            delimiters: ['', ''],
+            values: {
+                '_token_stack:': ''
+            }
+        }),
+        flow(),
+        json(),
+        buble({transforms, objectAssign: "Object.assign"}),
+        unassert(),
+        resolve({
+            browser: true,
+            preferBuiltins: false
+        }),
+        commonjs()
+    ]
+}];
+export default config;

package/src/style-spec/style-spec.js

@@ -0,0 +1,124 @@
+// @flow
+
+type ExpressionType = 'data-driven' | 'cross-faded' | 'cross-faded-data-driven' | 'color-ramp' | 'data-constant' | 'constant';
+type ExpressionParameters = Array<'zoom' | 'feature' | 'feature-state' | 'heatmap-density' | 'line-progress'>;
+
+type ExpressionSpecification = {
+    interpolated: boolean,
+    parameters: ExpressionParameters
+}
+
+export type StylePropertySpecification = {
+    type: 'number',
+    'property-type': ExpressionType,
+    expression?: ExpressionSpecification,
+    transition: boolean,
+    default?: number
+} | {
+    type: 'string',
+    'property-type': ExpressionType,
+    expression?: ExpressionSpecification,
+    transition: boolean,
+    default?: string,
+    tokens?: boolean
+} | {
+    type: 'boolean',
+    'property-type': ExpressionType,
+    expression?: ExpressionSpecification,
+    transition: boolean,
+    default?: boolean
+} | {
+    type: 'enum',
+    'property-type': ExpressionType,
+    expression?: ExpressionSpecification,
+    values: {[_: string]: {}},
+    transition: boolean,
+    default?: string
+} | {
+    type: 'color',
+    'property-type': ExpressionType,
+    expression?: ExpressionSpecification,
+    transition: boolean,
+    default?: string,
+    overridable: boolean
+} | {
+    type: 'array',
+    value: 'number',
+    'property-type': ExpressionType,
+    expression?: ExpressionSpecification,
+    length?: number,
+    transition: boolean,
+    default?: Array<number>
+} | {
+    type: 'array',
+    value: 'string',
+    'property-type': ExpressionType,
+    expression?: ExpressionSpecification,
+    length?: number,
+    transition: boolean,
+    default?: Array<string>
+};
+
+import v8 from './reference/v8.json';
+import latest from './reference/latest';
+import format from './format';
+import migrate from './migrate';
+import composite from './composite';
+import derefLayers from './deref';
+import diff from './diff';
+import ValidationError from './error/validation_error';
+import ParsingError from './error/parsing_error';
+import {StyleExpression, isExpression, createExpression, createPropertyExpression, normalizePropertyExpression, ZoomConstantExpression, ZoomDependentExpression, StylePropertyFunction} from './expression';
+import featureFilter, {isExpressionFilter} from './feature_filter';
+
+import convertFilter from './feature_filter/convert';
+import Color from './util/color';
+import {createFunction, isFunction} from './function';
+import convertFunction from './function/convert';
+import {eachSource, eachLayer, eachProperty} from './visit';
+
+import validate from './validate_style';
+import validateMapboxApiSupported from './validate_mapbox_api_supported';
+
+const expression = {
+    StyleExpression,
+    isExpression,
+    isExpressionFilter,
+    createExpression,
+    createPropertyExpression,
+    normalizePropertyExpression,
+    ZoomConstantExpression,
+    ZoomDependentExpression,
+    StylePropertyFunction
+};
+
+const styleFunction = {
+    convertFunction,
+    createFunction,
+    isFunction
+};
+
+const visit = {eachSource, eachLayer, eachProperty};
+
+export {
+    v8,
+    latest,
+    format,
+    migrate,
+    composite,
+    derefLayers,
+    diff,
+    ValidationError,
+    ParsingError,
+    expression,
+    featureFilter,
+    convertFilter,
+    Color,
+    styleFunction as function,
+    validate,
+    validateMapboxApiSupported,
+    visit
+};
+
+validate.parsed = validate;
+validate.latest = validate;

package/src/style-spec/types.js

@@ -0,0 +1,432 @@
+// @flow
+// Generated code; do not edit. Edit build/generate-flow-typed-style-spec.js instead.
+/* eslint-disable */
+
+export type ColorSpecification = string;
+
+export type FormattedSpecification = string;
+
+export type ResolvedImageSpecification = string;
+
+export type PromoteIdSpecification = {[_: string]: string} | string;
+
+export type FilterSpecification =
+    | ['has', string]
+    | ['!has', string]
+    | ['==', string, string | number | boolean]
+    | ['!=', string, string | number | boolean]
+    | ['>', string, string | number | boolean]
+    | ['>=', string, string | number | boolean]
+    | ['<', string, string | number | boolean]
+    | ['<=', string, string | number | boolean]
+    | Array<string | FilterSpecification>; // Can't type in, !in, all, any, none -- https://github.com/facebook/flow/issues/2443
+
+export type TransitionSpecification = {
+    duration?: number,
+    delay?: number
+};
+
+// Note: doesn't capture interpolatable vs. non-interpolatable types.
+
+export type CameraFunctionSpecification<T> =
+    | {| type: 'exponential', stops: Array<[number, T]> |}
+    | {| type: 'interval',    stops: Array<[number, T]> |};
+
+export type SourceFunctionSpecification<T> =
+    | {| type: 'exponential', stops: Array<[number, T]>, property: string, default?: T |}
+    | {| type: 'interval',    stops: Array<[number, T]>, property: string, default?: T |}
+    | {| type: 'categorical', stops: Array<[string | number | boolean, T]>, property: string, default?: T |}
+    | {| type: 'identity', property: string, default?: T |};
+
+export type CompositeFunctionSpecification<T> =
+    | {| type: 'exponential', stops: Array<[{zoom: number, value: number}, T]>, property: string, default?: T |}
+    | {| type: 'interval',    stops: Array<[{zoom: number, value: number}, T]>, property: string, default?: T |}
+    | {| type: 'categorical', stops: Array<[{zoom: number, value: string | number | boolean}, T]>, property: string, default?: T |};
+
+export type ExpressionSpecification = Array<mixed>;
+
+export type PropertyValueSpecification<T> =
+    | T
+    | CameraFunctionSpecification<T>
+    | ExpressionSpecification;
+
+export type DataDrivenPropertyValueSpecification<T> =
+    | T
+    | CameraFunctionSpecification<T>
+    | SourceFunctionSpecification<T>
+    | CompositeFunctionSpecification<T>
+    | ExpressionSpecification;
+
+export type StyleSpecification = {|
+    "version": 8,
+    "name"?: string,
+    "metadata"?: mixed,
+    "center"?: Array<number>,
+    "zoom"?: number,
+    "bearing"?: number,
+    "pitch"?: number,
+    "light"?: LightSpecification,
+    "sources": {[_: string]: SourceSpecification},
+    "sprite"?: string,
+    "glyphs"?: string,
+    "transition"?: TransitionSpecification,
+    "layers": Array<LayerSpecification>
+|}
+
+export type LightSpecification = {|
+    "anchor"?: PropertyValueSpecification<"map" | "viewport">,
+    "position"?: PropertyValueSpecification<[number, number, number]>,
+    "color"?: PropertyValueSpecification<ColorSpecification>,
+    "intensity"?: PropertyValueSpecification<number>
+|}
+
+export type VectorSourceSpecification = {
+    "type": "vector",
+    "url"?: string,
+    "tiles"?: Array<string>,
+    "bounds"?: [number, number, number, number],
+    "scheme"?: "xyz" | "tms",
+    "minzoom"?: number,
+    "maxzoom"?: number,
+    "attribution"?: string,
+    "promoteId"?: PromoteIdSpecification,
+    "volatile"?: boolean
+}
+
+export type RasterSourceSpecification = {
+    "type": "raster",
+    "url"?: string,
+    "tiles"?: Array<string>,
+    "bounds"?: [number, number, number, number],
+    "minzoom"?: number,
+    "maxzoom"?: number,
+    "tileSize"?: number,
+    "scheme"?: "xyz" | "tms",
+    "attribution"?: string,
+    "volatile"?: boolean
+}
+
+export type RasterDEMSourceSpecification = {
+    "type": "raster-dem",
+    "url"?: string,
+    "tiles"?: Array<string>,
+    "bounds"?: [number, number, number, number],
+    "minzoom"?: number,
+    "maxzoom"?: number,
+    "tileSize"?: number,
+    "attribution"?: string,
+    "encoding"?: "terrarium" | "mapbox",
+    "volatile"?: boolean
+}
+
+export type GeoJSONSourceSpecification = {|
+    "type": "geojson",
+    "data"?: mixed,
+    "maxzoom"?: number,
+    "attribution"?: string,
+    "buffer"?: number,
+    "filter"?: mixed,
+    "tolerance"?: number,
+    "cluster"?: boolean,
+    "clusterRadius"?: number,
+    "clusterMaxZoom"?: number,
+    "clusterMinPoints"?: number,
+    "clusterProperties"?: mixed,
+    "lineMetrics"?: boolean,
+    "generateId"?: boolean,
+    "promoteId"?: PromoteIdSpecification
+|}
+
+export type VideoSourceSpecification = {|
+    "type": "video",
+    "urls": Array<string>,
+    "coordinates": [[number, number], [number, number], [number, number], [number, number]]
+|}
+
+export type ImageSourceSpecification = {|
+    "type": "image",
+    "url": string,
+    "coordinates": [[number, number], [number, number], [number, number], [number, number]]
+|}
+
+export type SourceSpecification =
+    | VectorSourceSpecification
+    | RasterSourceSpecification
+    | RasterDEMSourceSpecification
+    | GeoJSONSourceSpecification
+    | VideoSourceSpecification
+    | ImageSourceSpecification
+
+export type FillLayerSpecification = {|
+    "id": string,
+    "type": "fill",
+    "metadata"?: mixed,
+    "source": string,
+    "source-layer"?: string,
+    "minzoom"?: number,
+    "maxzoom"?: number,
+    "filter"?: FilterSpecification,
+    "layout"?: {|
+        "fill-sort-key"?: DataDrivenPropertyValueSpecification<number>,
+        "visibility"?: "visible" | "none"
+    |},
+    "paint"?: {|
+        "fill-antialias"?: PropertyValueSpecification<boolean>,
+        "fill-opacity"?: DataDrivenPropertyValueSpecification<number>,
+        "fill-color"?: DataDrivenPropertyValueSpecification<ColorSpecification>,
+        "fill-outline-color"?: DataDrivenPropertyValueSpecification<ColorSpecification>,
+        "fill-translate"?: PropertyValueSpecification<[number, number]>,
+        "fill-translate-anchor"?: PropertyValueSpecification<"map" | "viewport">,
+        "fill-pattern"?: DataDrivenPropertyValueSpecification<ResolvedImageSpecification>
+    |}
+|}
+
+export type LineLayerSpecification = {|
+    "id": string,
+    "type": "line",
+    "metadata"?: mixed,
+    "source": string,
+    "source-layer"?: string,
+    "minzoom"?: number,
+    "maxzoom"?: number,
+    "filter"?: FilterSpecification,
+    "layout"?: {|
+        "line-cap"?: PropertyValueSpecification<"butt" | "round" | "square">,
+        "line-join"?: DataDrivenPropertyValueSpecification<"bevel" | "round" | "miter">,
+        "line-miter-limit"?: PropertyValueSpecification<number>,
+        "line-round-limit"?: PropertyValueSpecification<number>,
+        "line-sort-key"?: DataDrivenPropertyValueSpecification<number>,
+        "visibility"?: "visible" | "none"
+    |},
+    "paint"?: {|
+        "line-opacity"?: DataDrivenPropertyValueSpecification<number>,
+        "line-color"?: DataDrivenPropertyValueSpecification<ColorSpecification>,
+        "line-translate"?: PropertyValueSpecification<[number, number]>,
+        "line-translate-anchor"?: PropertyValueSpecification<"map" | "viewport">,
+        "line-width"?: DataDrivenPropertyValueSpecification<number>,
+        "line-gap-width"?: DataDrivenPropertyValueSpecification<number>,
+        "line-offset"?: DataDrivenPropertyValueSpecification<number>,
+        "line-blur"?: DataDrivenPropertyValueSpecification<number>,
+        "line-dasharray"?: PropertyValueSpecification<Array<number>>,
+        "line-pattern"?: DataDrivenPropertyValueSpecification<ResolvedImageSpecification>,
+        "line-gradient"?: ExpressionSpecification
+    |}
+|}
+
+export type SymbolLayerSpecification = {|
+    "id": string,
+    "type": "symbol",
+    "metadata"?: mixed,
+    "source": string,
+    "source-layer"?: string,
+    "minzoom"?: number,
+    "maxzoom"?: number,
+    "filter"?: FilterSpecification,
+    "layout"?: {|
+        "symbol-placement"?: PropertyValueSpecification<"point" | "line" | "line-center">,
+        "symbol-spacing"?: PropertyValueSpecification<number>,
+        "symbol-avoid-edges"?: PropertyValueSpecification<boolean>,
+        "symbol-sort-key"?: DataDrivenPropertyValueSpecification<number>,
+        "symbol-z-order"?: PropertyValueSpecification<"auto" | "viewport-y" | "source">,
+        "icon-allow-overlap"?: PropertyValueSpecification<boolean>,
+        "icon-ignore-placement"?: PropertyValueSpecification<boolean>,
+        "icon-optional"?: PropertyValueSpecification<boolean>,
+        "icon-rotation-alignment"?: PropertyValueSpecification<"map" | "viewport" | "auto">,
+        "icon-size"?: DataDrivenPropertyValueSpecification<number>,
+        "icon-text-fit"?: PropertyValueSpecification<"none" | "width" | "height" | "both">,
+        "icon-text-fit-padding"?: PropertyValueSpecification<[number, number, number, number]>,
+        "icon-image"?: DataDrivenPropertyValueSpecification<ResolvedImageSpecification>,
+        "icon-rotate"?: DataDrivenPropertyValueSpecification<number>,
+        "icon-padding"?: PropertyValueSpecification<number>,
+        "icon-keep-upright"?: PropertyValueSpecification<boolean>,
+        "icon-offset"?: DataDrivenPropertyValueSpecification<[number, number]>,
+        "icon-anchor"?: DataDrivenPropertyValueSpecification<"center" | "left" | "right" | "top" | "bottom" | "top-left" | "top-right" | "bottom-left" | "bottom-right">,
+        "icon-pitch-alignment"?: PropertyValueSpecification<"map" | "viewport" | "auto">,
+        "text-pitch-alignment"?: PropertyValueSpecification<"map" | "viewport" | "auto">,
+        "text-rotation-alignment"?: PropertyValueSpecification<"map" | "viewport" | "auto">,
+        "text-field"?: DataDrivenPropertyValueSpecification<FormattedSpecification>,
+        "text-font"?: DataDrivenPropertyValueSpecification<Array<string>>,
+        "text-size"?: DataDrivenPropertyValueSpecification<number>,
+        "text-max-width"?: DataDrivenPropertyValueSpecification<number>,
+        "text-line-height"?: PropertyValueSpecification<number>,
+        "text-letter-spacing"?: DataDrivenPropertyValueSpecification<number>,
+        "text-justify"?: DataDrivenPropertyValueSpecification<"auto" | "left" | "center" | "right">,
+        "text-radial-offset"?: DataDrivenPropertyValueSpecification<number>,
+        "text-variable-anchor"?: PropertyValueSpecification<Array<"center" | "left" | "right" | "top" | "bottom" | "top-left" | "top-right" | "bottom-left" | "bottom-right">>,
+        "text-anchor"?: DataDrivenPropertyValueSpecification<"center" | "left" | "right" | "top" | "bottom" | "top-left" | "top-right" | "bottom-left" | "bottom-right">,
+        "text-max-angle"?: PropertyValueSpecification<number>,
+        "text-writing-mode"?: PropertyValueSpecification<Array<"horizontal" | "vertical">>,
+        "text-rotate"?: DataDrivenPropertyValueSpecification<number>,
+        "text-padding"?: PropertyValueSpecification<number>,
+        "text-keep-upright"?: PropertyValueSpecification<boolean>,
+        "text-transform"?: DataDrivenPropertyValueSpecification<"none" | "uppercase" | "lowercase">,
+        "text-offset"?: DataDrivenPropertyValueSpecification<[number, number]>,
+        "text-allow-overlap"?: PropertyValueSpecification<boolean>,
+        "text-ignore-placement"?: PropertyValueSpecification<boolean>,
+        "text-optional"?: PropertyValueSpecification<boolean>,
+        "visibility"?: "visible" | "none"
+    |},
+    "paint"?: {|
+        "icon-opacity"?: DataDrivenPropertyValueSpecification<number>,
+        "icon-color"?: DataDrivenPropertyValueSpecification<ColorSpecification>,
+        "icon-halo-color"?: DataDrivenPropertyValueSpecification<ColorSpecification>,
+        "icon-halo-width"?: DataDrivenPropertyValueSpecification<number>,
+        "icon-halo-blur"?: DataDrivenPropertyValueSpecification<number>,
+        "icon-translate"?: PropertyValueSpecification<[number, number]>,
+        "icon-translate-anchor"?: PropertyValueSpecification<"map" | "viewport">,
+        "text-opacity"?: DataDrivenPropertyValueSpecification<number>,
+        "text-color"?: DataDrivenPropertyValueSpecification<ColorSpecification>,
+        "text-halo-color"?: DataDrivenPropertyValueSpecification<ColorSpecification>,
+        "text-halo-width"?: DataDrivenPropertyValueSpecification<number>,
+        "text-halo-blur"?: DataDrivenPropertyValueSpecification<number>,
+        "text-translate"?: PropertyValueSpecification<[number, number]>,
+        "text-translate-anchor"?: PropertyValueSpecification<"map" | "viewport">
+    |}
+|}
+
+export type CircleLayerSpecification = {|
+    "id": string,
+    "type": "circle",
+    "metadata"?: mixed,
+    "source": string,
+    "source-layer"?: string,
+    "minzoom"?: number,
+    "maxzoom"?: number,
+    "filter"?: FilterSpecification,
+    "layout"?: {|
+        "circle-sort-key"?: DataDrivenPropertyValueSpecification<number>,
+        "visibility"?: "visible" | "none"
+    |},
+    "paint"?: {|
+        "circle-radius"?: DataDrivenPropertyValueSpecification<number>,
+        "circle-color"?: DataDrivenPropertyValueSpecification<ColorSpecification>,
+        "circle-blur"?: DataDrivenPropertyValueSpecification<number>,
+        "circle-opacity"?: DataDrivenPropertyValueSpecification<number>,
+        "circle-translate"?: PropertyValueSpecification<[number, number]>,
+        "circle-translate-anchor"?: PropertyValueSpecification<"map" | "viewport">,
+        "circle-pitch-scale"?: PropertyValueSpecification<"map" | "viewport">,
+        "circle-pitch-alignment"?: PropertyValueSpecification<"map" | "viewport">,
+        "circle-stroke-width"?: DataDrivenPropertyValueSpecification<number>,
+        "circle-stroke-color"?: DataDrivenPropertyValueSpecification<ColorSpecification>,
+        "circle-stroke-opacity"?: DataDrivenPropertyValueSpecification<number>
+    |}
+|}
+
+export type HeatmapLayerSpecification = {|
+    "id": string,
+    "type": "heatmap",
+    "metadata"?: mixed,
+    "source": string,
+    "source-layer"?: string,
+    "minzoom"?: number,
+    "maxzoom"?: number,
+    "filter"?: FilterSpecification,
+    "layout"?: {|
+        "visibility"?: "visible" | "none"
+    |},
+    "paint"?: {|
+        "heatmap-radius"?: DataDrivenPropertyValueSpecification<number>,
+        "heatmap-weight"?: DataDrivenPropertyValueSpecification<number>,
+        "heatmap-intensity"?: PropertyValueSpecification<number>,
+        "heatmap-color"?: ExpressionSpecification,
+        "heatmap-opacity"?: PropertyValueSpecification<number>
+    |}
+|}
+
+export type FillExtrusionLayerSpecification = {|
+    "id": string,
+    "type": "fill-extrusion",
+    "metadata"?: mixed,
+    "source": string,
+    "source-layer"?: string,
+    "minzoom"?: number,
+    "maxzoom"?: number,
+    "filter"?: FilterSpecification,
+    "layout"?: {|
+        "visibility"?: "visible" | "none"
+    |},
+    "paint"?: {|
+        "fill-extrusion-opacity"?: PropertyValueSpecification<number>,
+        "fill-extrusion-color"?: DataDrivenPropertyValueSpecification<ColorSpecification>,
+        "fill-extrusion-translate"?: PropertyValueSpecification<[number, number]>,
+        "fill-extrusion-translate-anchor"?: PropertyValueSpecification<"map" | "viewport">,
+        "fill-extrusion-pattern"?: DataDrivenPropertyValueSpecification<ResolvedImageSpecification>,
+        "fill-extrusion-height"?: DataDrivenPropertyValueSpecification<number>,
+        "fill-extrusion-base"?: DataDrivenPropertyValueSpecification<number>,
+        "fill-extrusion-vertical-gradient"?: PropertyValueSpecification<boolean>
+    |}
+|}
+
+export type RasterLayerSpecification = {|
+    "id": string,
+    "type": "raster",
+    "metadata"?: mixed,
+    "source": string,
+    "source-layer"?: string,
+    "minzoom"?: number,
+    "maxzoom"?: number,
+    "filter"?: FilterSpecification,
+    "layout"?: {|
+        "visibility"?: "visible" | "none"
+    |},
+    "paint"?: {|
+        "raster-opacity"?: PropertyValueSpecification<number>,
+        "raster-hue-rotate"?: PropertyValueSpecification<number>,
+        "raster-brightness-min"?: PropertyValueSpecification<number>,
+        "raster-brightness-max"?: PropertyValueSpecification<number>,
+        "raster-saturation"?: PropertyValueSpecification<number>,
+        "raster-contrast"?: PropertyValueSpecification<number>,
+        "raster-resampling"?: PropertyValueSpecification<"linear" | "nearest">,
+        "raster-fade-duration"?: PropertyValueSpecification<number>
+    |}
+|}
+
+export type HillshadeLayerSpecification = {|
+    "id": string,
+    "type": "hillshade",
+    "metadata"?: mixed,
+    "source": string,
+    "source-layer"?: string,
+    "minzoom"?: number,
+    "maxzoom"?: number,
+    "filter"?: FilterSpecification,
+    "layout"?: {|
+        "visibility"?: "visible" | "none"
+    |},
+    "paint"?: {|
+        "hillshade-illumination-direction"?: PropertyValueSpecification<number>,
+        "hillshade-illumination-anchor"?: PropertyValueSpecification<"map" | "viewport">,
+        "hillshade-exaggeration"?: PropertyValueSpecification<number>,
+        "hillshade-shadow-color"?: PropertyValueSpecification<ColorSpecification>,
+        "hillshade-highlight-color"?: PropertyValueSpecification<ColorSpecification>,
+        "hillshade-accent-color"?: PropertyValueSpecification<ColorSpecification>
+    |}
+|}
+
+export type BackgroundLayerSpecification = {|
+    "id": string,
+    "type": "background",
+    "metadata"?: mixed,
+    "minzoom"?: number,
+    "maxzoom"?: number,
+    "layout"?: {|
+        "visibility"?: "visible" | "none"
+    |},
+    "paint"?: {|
+        "background-color"?: PropertyValueSpecification<ColorSpecification>,
+        "background-pattern"?: PropertyValueSpecification<ResolvedImageSpecification>,
+        "background-opacity"?: PropertyValueSpecification<number>
+    |}
+|}
+
+export type LayerSpecification =
+    | FillLayerSpecification
+    | LineLayerSpecification
+    | SymbolLayerSpecification
+    | CircleLayerSpecification
+    | HeatmapLayerSpecification
+    | FillExtrusionLayerSpecification
+    | RasterLayerSpecification
+    | HillshadeLayerSpecification
+    | BackgroundLayerSpecification;
+