@mapbox/mapbox-gl-style-spec 14.7.0 → 14.8.0-beta.1

package/dist/index.d.ts

@@ -300,6 +300,7 @@ type FeaturesetsSpecification = {
 	[_: string]: FeaturesetSpecification;
 };
 type FeaturesetSpecification = {
+	"metadata"?: unknown;
 	"selectors"?: Array<SelectorSpecification>;
 };
 type SelectorSpecification = {
@@ -554,6 +555,14 @@ type LineLayerSpecification = {
 		 * @experimental This property is experimental and subject to change in future versions.
 		 */
 		"line-z-offset"?: DataDrivenPropertyValueSpecification<number>;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
+		"line-elevation-reference"?: "none" | "sea" | "ground" | "hd-road-markup" | ExpressionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
+		"line-cross-slope"?: ExpressionSpecification;
 		"visibility"?: "visible" | "none" | ExpressionSpecification;
 	};
 	"paint"?: {
@@ -623,6 +632,10 @@ type SymbolLayerSpecification = {
 		"icon-optional"?: PropertyValueSpecification<boolean>;
 		"icon-rotation-alignment"?: PropertyValueSpecification<"map" | "viewport" | "auto">;
 		"icon-size"?: DataDrivenPropertyValueSpecification<number>;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
+		"icon-size-scale-range"?: ExpressionSpecification;
 		"icon-text-fit"?: DataDrivenPropertyValueSpecification<"none" | "width" | "height" | "both">;
 		"icon-text-fit-padding"?: DataDrivenPropertyValueSpecification<[
 			number,
@@ -645,6 +658,10 @@ type SymbolLayerSpecification = {
 		"text-field"?: DataDrivenPropertyValueSpecification<FormattedSpecification>;
 		"text-font"?: DataDrivenPropertyValueSpecification<Array<string>>;
 		"text-size"?: DataDrivenPropertyValueSpecification<number>;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
+		"text-size-scale-range"?: ExpressionSpecification;
 		"text-max-width"?: DataDrivenPropertyValueSpecification<number>;
 		"text-line-height"?: DataDrivenPropertyValueSpecification<number>;
 		"text-letter-spacing"?: DataDrivenPropertyValueSpecification<number>;
@@ -820,6 +837,14 @@ type FillExtrusionLayerSpecification = {
 		"fill-extrusion-height-transition"?: TransitionSpecification;
 		"fill-extrusion-base"?: DataDrivenPropertyValueSpecification<number>;
 		"fill-extrusion-base-transition"?: TransitionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
+		"fill-extrusion-height-alignment"?: "terrain" | "flat";
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
+		"fill-extrusion-base-alignment"?: "terrain" | "flat";
 		"fill-extrusion-vertical-gradient"?: PropertyValueSpecification<boolean>;
 		"fill-extrusion-ambient-occlusion-intensity"?: PropertyValueSpecification<number>;
 		"fill-extrusion-ambient-occlusion-intensity-transition"?: TransitionSpecification;

package/dist/index.es.js

@@ -244,6 +244,10 @@ var featuresets = {
 };
 var featureset = {
 	experimental: true,
+	metadata: {
+		type: "*",
+		doc: "Arbitrary properties useful to track with the stylesheet, but do not influence rendering. Properties should be prefixed to avoid collisions, like 'mapbox:'."
+	},
 	selectors: {
 		type: "array",
 		value: "selector",
@@ -1277,7 +1281,6 @@ var layer = {
 			},
 			clip: {
 				doc: "Layer that removes 3D content from map.",
-				experimental: true,
 				"sdk-support": {
 					"basic functionality": {
 						js: "3.5.0",
@@ -1818,7 +1821,11 @@ var layout_line = {
 	"line-z-offset": {
 		type: "number",
 		experimental: true,
-		doc: "Vertical offset from ground, in meters. Defaults to 0. Not supported for globe projection at the moment.",
+		doc: "Vertical offset from ground, in meters. Defaults to 0. This is an experimental property with some known issues:\n * Not supported for globe projection at the moment \n * Elevated line discontinuity is possible on tile borders with terrain enabled \n * Rendering artifacts can happen near line joins and line caps depending on the line styling \n * Rendering artifacts relating to `line-opacity` and `line-blur` \n * Elevated line visibility is determined by layer order \n * Z-fighting issues can happen with intersecting elevated lines \n * Elevated lines don't cast shadows",
+		"default": 0,
+		requires: [
+			"line-elevation-reference"
+		],
 		"sdk-support": {
 			"basic functionality": {
 				js: "3.5.0",
@@ -1841,6 +1848,57 @@ var layout_line = {
 		},
 		"property-type": "data-driven"
 	},
+	"line-elevation-reference": {
+		type: "enum",
+		doc: "Selects the base of line-elevation. Some modes might require precomputed elevation data in the tileset.",
+		values: {
+			none: {
+				doc: "Elevated rendering is disabled."
+			},
+			sea: {
+				doc: "Elevated rendering is enabled. Use this mode to elevate lines relative to the sea level."
+			},
+			ground: {
+				doc: "Elevated rendering is enabled. Use this mode to elevate lines relative to the ground's height below them."
+			},
+			"hd-road-markup": {
+				doc: "Elevated rendering is enabled. Use this mode to describe additive and stackable features that should exist only on top of road polygons."
+			}
+		},
+		"default": "none",
+		experimental: true,
+		transition: false,
+		"sdk-support": {
+			"basic functionality": {
+				js: "3.8.0",
+				android: "11.9.0",
+				ios: "11.9.0"
+			}
+		},
+		expression: {
+			interpolated: false
+		},
+		"property-type": "data-constant"
+	},
+	"line-cross-slope": {
+		type: "number",
+		experimental: true,
+		doc: "Defines the slope of an elevated line. A value of 0 creates a horizontal line. A value of 1 creates a vertical line. Other values are currently not supported. If undefined, the line follows the terrain slope. This is an experimental property with some known issues:\n * Vertical lines don't support line caps \n * `line-join: round` is not supported with this property",
+		requires: [
+			"line-z-offset"
+		],
+		"sdk-support": {
+			"basic functionality": {
+				js: "3.8.0",
+				android: "11.9.0",
+				ios: "11.9.0"
+			}
+		},
+		expression: {
+			interpolated: false
+		},
+		"property-type": "constant"
+	},
 	visibility: {
 		type: "enum",
 		values: {
@@ -2172,6 +2230,31 @@ var layout_symbol = {
 		},
 		"property-type": "data-driven"
 	},
+	"icon-size-scale-range": {
+		type: "array",
+		value: "number",
+		length: 2,
+		"default": [
+			0.8,
+			2
+		],
+		doc: "Defines the minimum and maximum scaling factors for icon related properties like `icon-size`, `icon-halo-width`, `icon-halo-blur`",
+		minimum: 0.1,
+		maximum: 10,
+		experimental: true,
+		"private": true,
+		expression: {
+			interpolated: false
+		},
+		"sdk-support": {
+			"basic functionality": {
+				js: "3.8.0",
+				android: "11.8.0",
+				ios: "11.8.0"
+			}
+		},
+		"property-type": "data-constant"
+	},
 	"icon-text-fit": {
 		type: "enum",
 		values: {
@@ -2661,6 +2744,31 @@ var layout_symbol = {
 		},
 		"property-type": "data-driven"
 	},
+	"text-size-scale-range": {
+		type: "array",
+		value: "number",
+		length: 2,
+		"default": [
+			0.8,
+			2
+		],
+		doc: "Defines the minimum and maximum scaling factors for text related properties like `text-size`, `text-max-width`, `text-halo-width`, `font-size`",
+		minimum: 0.1,
+		maximum: 10,
+		experimental: true,
+		"private": true,
+		expression: {
+			interpolated: false
+		},
+		"sdk-support": {
+			"basic functionality": {
+				js: "3.8.0",
+				android: "11.8.0",
+				ios: "11.8.0"
+			}
+		},
+		"property-type": "data-constant"
+	},
 	"text-max-width": {
 		type: "number",
 		"default": 10,
@@ -4767,6 +4875,360 @@ var fog = {
 		}
 	}
 };
+var snow = {
+	density: {
+		type: "number",
+		"property-type": "data-constant",
+		"default": 1,
+		minimum: 0,
+		maximum: 1,
+		experimental: true,
+		expression: {
+			interpolated: true,
+			parameters: [
+				"zoom",
+				"measure-light"
+			],
+			relaxZoomRestriction: true
+		},
+		transition: true,
+		doc: "Snow particles density.",
+		"sdk-support": {
+			"basic functionality": {
+				android: "11.8.0",
+				ios: "11.8.0"
+			}
+		}
+	},
+	intensity: {
+		type: "number",
+		"property-type": "data-constant",
+		"default": 1,
+		minimum: 0,
+		maximum: 1,
+		experimental: true,
+		expression: {
+			interpolated: true,
+			parameters: [
+				"zoom",
+				"measure-light"
+			],
+			relaxZoomRestriction: true
+		},
+		transition: true,
+		doc: "Snow particles movement factor.",
+		"sdk-support": {
+			"basic functionality": {
+				android: "11.8.0",
+				ios: "11.8.0"
+			}
+		}
+	},
+	color: {
+		type: "color",
+		"property-type": "data-constant",
+		"default": "#ffffff",
+		experimental: true,
+		expression: {
+			interpolated: true,
+			parameters: [
+				"zoom",
+				"measure-light"
+			],
+			relaxZoomRestriction: true
+		},
+		transition: true,
+		doc: "Snow particles color.",
+		"sdk-support": {
+			"basic functionality": {
+				android: "11.8.0",
+				ios: "11.8.0"
+			}
+		}
+	},
+	opacity: {
+		type: "number",
+		"property-type": "data-constant",
+		"default": 1,
+		minimum: 0,
+		maximum: 1,
+		experimental: true,
+		expression: {
+			interpolated: true,
+			parameters: [
+				"zoom",
+				"measure-light"
+			],
+			relaxZoomRestriction: true
+		},
+		transition: true,
+		doc: "Snow particles opacity.",
+		"sdk-support": {
+			"basic functionality": {
+				android: "11.8.0",
+				ios: "11.8.0"
+			}
+		}
+	},
+	vignette: {
+		type: "number",
+		"property-type": "data-constant",
+		"default": 0,
+		minimum: 0,
+		maximum: 1,
+		experimental: true,
+		expression: {
+			interpolated: true,
+			parameters: [
+				"zoom",
+				"measure-light"
+			],
+			relaxZoomRestriction: true
+		},
+		transition: true,
+		doc: "Snow vignette screen-space effect.",
+		"sdk-support": {
+			"basic functionality": {
+				android: "11.8.0",
+				ios: "11.8.0"
+			}
+		}
+	},
+	centerThinning: {
+		type: "number",
+		"property-type": "data-constant",
+		"default": 1,
+		minimum: 0,
+		maximum: 1,
+		experimental: true,
+		expression: {
+			interpolated: true,
+			parameters: [
+				"zoom",
+				"measure-light"
+			],
+			relaxZoomRestriction: true
+		},
+		transition: true,
+		doc: "Thinning factor of snow particles from center. 0 - no thinning. 1 - maximal central area thinning.",
+		"sdk-support": {
+			"basic functionality": {
+				android: "11.8.0",
+				ios: "11.8.0"
+			}
+		}
+	},
+	direction: {
+		type: "array",
+		"default": [
+			0,
+			90
+		],
+		minimum: 0,
+		maximum: 360,
+		length: 2,
+		value: "number",
+		"property-type": "data-constant",
+		transition: true,
+		experimental: true,
+		expression: {
+			interpolated: true,
+			parameters: [
+				"zoom",
+				"measure-light"
+			],
+			relaxZoomRestriction: true
+		},
+		doc: "Main snow particles direction. Heading & pitch",
+		example: [
+			0,
+			45
+		],
+		"sdk-support": {
+			"basic functionality": {
+				android: "11.8.0",
+				ios: "11.8.0"
+			}
+		}
+	}
+};
+var rain = {
+	density: {
+		type: "number",
+		"property-type": "data-constant",
+		"default": 1,
+		minimum: 0,
+		maximum: 1,
+		experimental: true,
+		expression: {
+			interpolated: true,
+			parameters: [
+				"zoom",
+				"measure-light"
+			],
+			relaxZoomRestriction: true
+		},
+		transition: true,
+		doc: "Rain particles density.",
+		"sdk-support": {
+			"basic functionality": {
+				android: "11.8.0",
+				ios: "11.8.0"
+			}
+		}
+	},
+	intensity: {
+		type: "number",
+		"property-type": "data-constant",
+		"default": 1,
+		minimum: 0,
+		maximum: 1,
+		experimental: true,
+		expression: {
+			interpolated: true,
+			parameters: [
+				"zoom",
+				"measure-light"
+			],
+			relaxZoomRestriction: true
+		},
+		transition: true,
+		doc: "Rain particles movement factor.",
+		"sdk-support": {
+			"basic functionality": {
+				android: "11.8.0",
+				ios: "11.8.0"
+			}
+		}
+	},
+	color: {
+		type: "color",
+		"property-type": "data-constant",
+		"default": "#ffffff",
+		experimental: true,
+		expression: {
+			interpolated: true,
+			parameters: [
+				"zoom",
+				"measure-light"
+			],
+			relaxZoomRestriction: true
+		},
+		transition: true,
+		doc: "",
+		"sdk-support": {
+			"basic functionality": {
+				android: "11.8.0",
+				ios: "11.8.0"
+			}
+		}
+	},
+	opacity: {
+		type: "number",
+		"property-type": "data-constant",
+		"default": 1,
+		minimum: 0,
+		maximum: 1,
+		experimental: true,
+		expression: {
+			interpolated: true,
+			parameters: [
+				"zoom",
+				"measure-light"
+			],
+			relaxZoomRestriction: true
+		},
+		transition: true,
+		doc: "Rain particles opacity.",
+		"sdk-support": {
+			"basic functionality": {
+				android: "11.8.0",
+				ios: "11.8.0"
+			}
+		}
+	},
+	vignette: {
+		type: "number",
+		"property-type": "data-constant",
+		"default": 0,
+		minimum: 0,
+		maximum: 1,
+		experimental: true,
+		expression: {
+			interpolated: true,
+			parameters: [
+				"zoom",
+				"measure-light"
+			],
+			relaxZoomRestriction: true
+		},
+		transition: true,
+		doc: "Rain vignette screen-space effect.",
+		"sdk-support": {
+			"basic functionality": {
+				android: "11.8.0",
+				ios: "11.8.0"
+			}
+		}
+	},
+	centerThinning: {
+		type: "number",
+		"property-type": "data-constant",
+		"default": 1,
+		minimum: 0,
+		maximum: 1,
+		experimental: true,
+		expression: {
+			interpolated: true,
+			parameters: [
+				"zoom",
+				"measure-light"
+			],
+			relaxZoomRestriction: true
+		},
+		transition: true,
+		doc: "Thinning factor of rain particles from center. 0 - no thinning. 1 - maximal central area thinning.",
+		"sdk-support": {
+			"basic functionality": {
+				android: "11.8.0",
+				ios: "11.8.0"
+			}
+		}
+	},
+	direction: {
+		type: "array",
+		"default": [
+			0,
+			80
+		],
+		minimum: 0,
+		maximum: 360,
+		length: 2,
+		value: "number",
+		"property-type": "data-constant",
+		transition: true,
+		experimental: true,
+		expression: {
+			interpolated: true,
+			parameters: [
+				"zoom",
+				"measure-light"
+			],
+			relaxZoomRestriction: true
+		},
+		doc: "Main rain particles direction. Heading & pitch",
+		example: [
+			0,
+			45
+		],
+		"sdk-support": {
+			"basic functionality": {
+				android: "11.8.0",
+				ios: "11.8.0"
+			}
+		}
+	}
+};
 var camera = {
 	"camera-projection": {
 		doc: "Camera projection describes how 3D world geometry get projected into 2D screen",
@@ -8685,6 +9147,8 @@ var v8 = {
 	expression: expression$1,
 	expression_name: expression_name,
 	fog: fog,
+	snow: snow,
+	rain: rain,
 	camera: camera,
 	colorTheme: colorTheme,
 	light: light,
@@ -8890,6 +9354,56 @@ var v8 = {
 		},
 		"property-type": "data-driven"
 	},
+	"fill-extrusion-height-alignment": {
+		type: "enum",
+		experimental: true,
+		values: {
+			terrain: {
+				doc: "The fill extrusion height follows terrain slope."
+			},
+			flat: {
+				doc: "The fill extrusion height is flat over terrain."
+			}
+		},
+		doc: "Controls the behavior of fill extrusion height over terrain",
+		"default": "flat",
+		requires: [
+			"fill-extrusion-height"
+		],
+		"sdk-support": {
+			"basic functionality": {
+				js: "3.8.0",
+				android: "11.8.0",
+				ios: "11.8.0"
+			}
+		},
+		"property-type": "data-constant"
+	},
+	"fill-extrusion-base-alignment": {
+		type: "enum",
+		experimental: true,
+		values: {
+			terrain: {
+				doc: "The fill extrusion base follows terrain slope."
+			},
+			flat: {
+				doc: "The fill extrusion base is flat over terrain."
+			}
+		},
+		doc: "Controls the behavior of fill extrusion base over terrain",
+		"default": "terrain",
+		requires: [
+			"fill-extrusion-base"
+		],
+		"sdk-support": {
+			"basic functionality": {
+				js: "3.8.0",
+				android: "11.8.0",
+				ios: "11.8.0"
+			}
+		},
+		"property-type": "data-constant"
+	},
 	"fill-extrusion-vertical-gradient": {
 		type: "boolean",
 		"default": true,
@@ -14592,13 +15106,21 @@ class At {
         if (index < 0) {
             throw new RuntimeError(`Array index out of bounds: ${ index } < 0.`);
         }
-        if (index >= array2.length) {
+        if (index > array2.length - 1) {
             throw new RuntimeError(`Array index out of bounds: ${ index } > ${ array2.length - 1 }.`);
         }
-        if (index !== Math.floor(index)) {
-            throw new RuntimeError(`Array index must be an integer, but found ${ index } instead.`);
+        if (index === Math.floor(index)) {
+            return array2[index];
+        }
+        const lowerIndex = Math.floor(index);
+        const upperIndex = Math.ceil(index);
+        const lowerValue = array2[lowerIndex];
+        const upperValue = array2[upperIndex];
+        if (typeof lowerValue !== 'number' || typeof upperValue !== 'number') {
+            throw new RuntimeError(`Cannot interpolate between non-number values at index ${ index }.`);
         }
-        return array2[index];
+        const fraction = index - lowerIndex;
+        return lowerValue * (1 - fraction) + upperValue * fraction;
     }
     eachChild(fn) {
         fn(this.index);