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

package/dist/index.cjs

@@ -113,6 +113,16 @@
   		type: "fog",
   		doc: "A global effect that fades layers and markers based on their distance to the camera. The fog can be used to approximate the effect of atmosphere on distant objects and enhance the depth perception of the map when used with terrain or 3D features. Note: fog is renamed to atmosphere in the Android and iOS SDKs and planned to be changed in GL-JS v.3.0.0."
   	},
+  	snow: {
+  		type: "snow",
+  		doc: "Global precipitation particle-based snow. Having snow present in the style forces constant map repaint mode",
+  		experimental: true
+  	},
+  	rain: {
+  		type: "rain",
+  		doc: "Global precipitation particle-based rain effect. Having rain present in the style forces constant map repaint mode.",
+  		experimental: true
+  	},
   	camera: {
   		type: "camera",
   		doc: "Global setting to control additional camera intrinsics parameters, e.g. projection type (perspective / orthographic)."
@@ -121,6 +131,11 @@
   		type: "colorTheme",
   		doc: "A global modifier for the colors of the style."
   	},
+  	indoor: {
+  		type: "indoor",
+  		experimental: true,
+  		doc: "Controls the behaviour of indoor features."
+  	},
   	imports: {
   		type: "array",
   		value: "import",
@@ -461,6 +476,28 @@
   			}
   		}
   	},
+  	"shadow-quality": {
+  		type: "number",
+  		"property-type": "data-constant",
+  		"default": 1,
+  		minimum: 0,
+  		maximum: 1,
+  		expression: {
+  			interpolated: false,
+  			parameters: [
+  				"zoom"
+  			]
+  		},
+  		transition: false,
+  		doc: "Determines the quality of the shadows on the map. A value of 1 ensures the highest quality and is the default value.",
+  		"sdk-support": {
+  			"basic functionality": {
+  				android: "11.9.0",
+  				ios: "11.9.0"
+  			}
+  		},
+  		experimental: true
+  	},
   	"shadow-intensity": {
   		type: "number",
   		"property-type": "data-constant",
@@ -1962,6 +1999,36 @@
   			interpolated: false
   		},
   		"property-type": "constant"
+  	},
+  	"line-width-unit": {
+  		type: "enum",
+  		doc: "Selects the unit of line-width. The same unit is automatically used for line-blur and line-offset. Note: This is an experimental property and might be removed in a future release.",
+  		values: {
+  			pixels: {
+  				doc: "Width is rendered in pixels."
+  			},
+  			meters: {
+  				doc: "Width is rendered in meters."
+  			}
+  		},
+  		"default": "pixels",
+  		experimental: true,
+  		"private": true,
+  		transition: false,
+  		"sdk-support": {
+  			"basic functionality": {
+  				js: "3.9.0",
+  				android: "11.9.0",
+  				ios: "11.9.0"
+  			}
+  		},
+  		expression: {
+  			interpolated: false,
+  			parameters: [
+  				"zoom"
+  			]
+  		},
+  		"property-type": "data-constant"
   	}
   };
   var layout_symbol = {
@@ -2076,7 +2143,7 @@
   				doc: "Sorts symbols by `symbol-sort-key` if set. Otherwise, sorts symbols by their y-position relative to the viewport if `icon-allow-overlap` or `text-allow-overlap` is set to `true` or `icon-ignore-placement` or `text-ignore-placement` is `false`."
   			},
   			"viewport-y": {
-  				doc: "Sorts symbols by their y-position relative to the viewport if `icon-allow-overlap` or `text-allow-overlap` is set to `true` or `icon-ignore-placement` or `text-ignore-placement` is `false`."
+  				doc: "Sorts symbols by their y-position relative to the viewport if any of the following is set to `true`: `icon-allow-overlap`, `text-allow-overlap`, `icon-ignore-placement`, `text-ignore-placement`."
   			},
   			source: {
   				doc: "Sorts symbols by `symbol-sort-key` if set. Otherwise, no sorting is applied; symbols are rendered in the same order as the source data."
@@ -2313,9 +2380,7 @@
   		},
   		"sdk-support": {
   			"basic functionality": {
-  				js: "3.8.0",
-  				android: "11.8.0",
-  				ios: "11.8.0"
+  				js: "3.8.0"
   			}
   		},
   		"property-type": "data-constant"
@@ -2827,9 +2892,7 @@
   		},
   		"sdk-support": {
   			"basic functionality": {
-  				js: "3.8.0",
-  				android: "11.8.0",
-  				ios: "11.8.0"
+  				js: "3.8.0"
   			}
   		},
   		"property-type": "data-constant"
@@ -4080,6 +4143,17 @@
   				}
   			}
   		},
+  		"to-hsla": {
+  			doc: "Returns a four-element array containing the input color's Hue, Saturation, Luminance and alpha components, in that order.",
+  			group: "Color",
+  			"sdk-support": {
+  				"basic functionality": {
+  					js: "3.9.0",
+  					android: "11.9.0",
+  					ios: "11.9.0"
+  				}
+  			}
+  		},
   		"to-color": {
   			doc: "Converts the input value to a color. If multiple values are provided, each one is evaluated in order until the first successful conversion is obtained. If none of the inputs can be converted, the expression is an error.",
   			group: "Types",
@@ -5013,11 +5087,11 @@
   			relaxZoomRestriction: true
   		},
   		transition: true,
-  		doc: "Snow particles density.",
+  		doc: "Snow particles density. Controls the overall particles number.",
   		"sdk-support": {
   			"basic functionality": {
-  				android: "11.8.0",
-  				ios: "11.8.0"
+  				android: "11.9.0",
+  				ios: "11.9.0"
   			}
   		}
   	},
@@ -5037,11 +5111,11 @@
   			relaxZoomRestriction: true
   		},
   		transition: true,
-  		doc: "Snow particles movement factor.",
+  		doc: "Snow particles movement factor. Controls the overall particles movement speed.",
   		"sdk-support": {
   			"basic functionality": {
-  				android: "11.8.0",
-  				ios: "11.8.0"
+  				android: "11.9.0",
+  				ios: "11.9.0"
   			}
   		}
   	},
@@ -5062,15 +5136,15 @@
   		doc: "Snow particles color.",
   		"sdk-support": {
   			"basic functionality": {
-  				android: "11.8.0",
-  				ios: "11.8.0"
+  				android: "11.9.0",
+  				ios: "11.9.0"
   			}
   		}
   	},
   	opacity: {
   		type: "number",
   		"property-type": "data-constant",
-  		"default": 1,
+  		"default": 0.9,
   		minimum: 0,
   		maximum: 1,
   		experimental: true,
@@ -5086,15 +5160,15 @@
   		doc: "Snow particles opacity.",
   		"sdk-support": {
   			"basic functionality": {
-  				android: "11.8.0",
-  				ios: "11.8.0"
+  				android: "11.9.0",
+  				ios: "11.9.0"
   			}
   		}
   	},
   	vignette: {
   		type: "number",
   		"property-type": "data-constant",
-  		"default": 0,
+  		"default": 0.3,
   		minimum: 0,
   		maximum: 1,
   		experimental: true,
@@ -5107,15 +5181,37 @@
   			relaxZoomRestriction: true
   		},
   		transition: true,
-  		doc: "Snow vignette screen-space effect.",
+  		doc: "Snow vignette screen-space effect. Adds snow tint to screen corners",
   		"sdk-support": {
   			"basic functionality": {
-  				android: "11.8.0",
-  				ios: "11.8.0"
+  				android: "11.9.0",
+  				ios: "11.9.0"
   			}
   		}
   	},
-  	centerThinning: {
+  	"vignette-color": {
+  		type: "color",
+  		"property-type": "data-constant",
+  		"default": "#ffffff",
+  		experimental: true,
+  		expression: {
+  			interpolated: true,
+  			parameters: [
+  				"zoom",
+  				"measure-light"
+  			],
+  			relaxZoomRestriction: true
+  		},
+  		transition: true,
+  		doc: "Snow vignette screen-space corners tint color.",
+  		"sdk-support": {
+  			"basic functionality": {
+  				android: "11.9.0",
+  				ios: "11.9.0"
+  			}
+  		}
+  	},
+  	"center-thinning": {
   		type: "number",
   		"property-type": "data-constant",
   		"default": 1,
@@ -5134,8 +5230,8 @@
   		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"
+  				android: "11.9.0",
+  				ios: "11.9.0"
   			}
   		}
   	},
@@ -5160,15 +5256,39 @@
   			],
   			relaxZoomRestriction: true
   		},
-  		doc: "Main snow particles direction. Heading & pitch",
+  		doc: "Main snow particles direction. Azimuth and polar angles",
   		example: [
   			0,
   			45
   		],
   		"sdk-support": {
   			"basic functionality": {
-  				android: "11.8.0",
-  				ios: "11.8.0"
+  				android: "11.9.0",
+  				ios: "11.9.0"
+  			}
+  		}
+  	},
+  	"flake-size": {
+  		type: "number",
+  		"property-type": "data-constant",
+  		"default": 1,
+  		minimum: 0,
+  		maximum: 5,
+  		experimental: true,
+  		expression: {
+  			interpolated: true,
+  			parameters: [
+  				"zoom",
+  				"measure-light"
+  			],
+  			relaxZoomRestriction: true
+  		},
+  		transition: true,
+  		doc: "Snow flake particle size. Correlates with individual particle screen size",
+  		"sdk-support": {
+  			"basic functionality": {
+  				android: "11.9.0",
+  				ios: "11.9.0"
   			}
   		}
   	}
@@ -5190,11 +5310,11 @@
   			relaxZoomRestriction: true
   		},
   		transition: true,
-  		doc: "Rain particles density.",
+  		doc: "Rain particles density. Controls the overall screen density of the rain.",
   		"sdk-support": {
   			"basic functionality": {
-  				android: "11.8.0",
-  				ios: "11.8.0"
+  				android: "11.9.0",
+  				ios: "11.9.0"
   			}
   		}
   	},
@@ -5214,18 +5334,18 @@
   			relaxZoomRestriction: true
   		},
   		transition: true,
-  		doc: "Rain particles movement factor.",
+  		doc: "Rain particles movement factor. Controls the overall rain particles speed",
   		"sdk-support": {
   			"basic functionality": {
-  				android: "11.8.0",
-  				ios: "11.8.0"
+  				android: "11.9.0",
+  				ios: "11.9.0"
   			}
   		}
   	},
   	color: {
   		type: "color",
   		"property-type": "data-constant",
-  		"default": "#ffffff",
+  		"default": "#919191",
   		experimental: true,
   		expression: {
   			interpolated: true,
@@ -5236,18 +5356,18 @@
   			relaxZoomRestriction: true
   		},
   		transition: true,
-  		doc: "",
+  		doc: "Individual rain particle dorplets color.",
   		"sdk-support": {
   			"basic functionality": {
-  				android: "11.8.0",
-  				ios: "11.8.0"
+  				android: "11.9.0",
+  				ios: "11.9.0"
   			}
   		}
   	},
   	opacity: {
   		type: "number",
   		"property-type": "data-constant",
-  		"default": 1,
+  		"default": 0.19,
   		minimum: 0,
   		maximum: 1,
   		experimental: true,
@@ -5263,15 +5383,15 @@
   		doc: "Rain particles opacity.",
   		"sdk-support": {
   			"basic functionality": {
-  				android: "11.8.0",
-  				ios: "11.8.0"
+  				android: "11.9.0",
+  				ios: "11.9.0"
   			}
   		}
   	},
   	vignette: {
   		type: "number",
   		"property-type": "data-constant",
-  		"default": 0,
+  		"default": 0.3,
   		minimum: 0,
   		maximum: 1,
   		experimental: true,
@@ -5284,15 +5404,37 @@
   			relaxZoomRestriction: true
   		},
   		transition: true,
-  		doc: "Rain vignette screen-space effect.",
+  		doc: "Screen-space vignette rain tinting effect intensity.",
   		"sdk-support": {
   			"basic functionality": {
-  				android: "11.8.0",
-  				ios: "11.8.0"
+  				android: "11.9.0",
+  				ios: "11.9.0"
+  			}
+  		}
+  	},
+  	"vignette-color": {
+  		type: "color",
+  		"property-type": "data-constant",
+  		"default": "#ffffff",
+  		experimental: true,
+  		expression: {
+  			interpolated: true,
+  			parameters: [
+  				"zoom",
+  				"measure-light"
+  			],
+  			relaxZoomRestriction: true
+  		},
+  		transition: true,
+  		doc: "Rain vignette screen-space corners tint color.",
+  		"sdk-support": {
+  			"basic functionality": {
+  				android: "11.9.0",
+  				ios: "11.9.0"
   			}
   		}
   	},
-  	centerThinning: {
+  	"center-thinning": {
   		type: "number",
   		"property-type": "data-constant",
   		"default": 1,
@@ -5311,8 +5453,8 @@
   		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"
+  				android: "11.9.0",
+  				ios: "11.9.0"
   			}
   		}
   	},
@@ -5337,15 +5479,72 @@
   			],
   			relaxZoomRestriction: true
   		},
-  		doc: "Main rain particles direction. Heading & pitch",
+  		doc: "Main rain particles direction. Azimuth and polar angles.",
   		example: [
   			0,
   			45
   		],
   		"sdk-support": {
   			"basic functionality": {
-  				android: "11.8.0",
-  				ios: "11.8.0"
+  				android: "11.9.0",
+  				ios: "11.9.0"
+  			}
+  		}
+  	},
+  	"droplet-size": {
+  		type: "array",
+  		"default": [
+  			1,
+  			10
+  		],
+  		minimum: 0,
+  		maximum: 20,
+  		length: 2,
+  		value: "number",
+  		"property-type": "data-constant",
+  		transition: true,
+  		experimental: true,
+  		expression: {
+  			interpolated: true,
+  			parameters: [
+  				"zoom",
+  				"measure-light"
+  			],
+  			relaxZoomRestriction: true
+  		},
+  		doc: "Rain droplet size. x - normal to direction, y - along direction",
+  		example: [
+  			0,
+  			45
+  		],
+  		"sdk-support": {
+  			"basic functionality": {
+  				android: "11.9.0",
+  				ios: "11.9.0"
+  			}
+  		}
+  	},
+  	"distortion-strength": {
+  		type: "number",
+  		"property-type": "data-constant",
+  		"default": 0.5,
+  		minimum: 0,
+  		maximum: 1,
+  		experimental: true,
+  		expression: {
+  			interpolated: true,
+  			parameters: [
+  				"zoom",
+  				"measure-light"
+  			],
+  			relaxZoomRestriction: true
+  		},
+  		transition: true,
+  		doc: "Rain particles screen-space distortion strength.",
+  		"sdk-support": {
+  			"basic functionality": {
+  				android: "11.9.0",
+  				ios: "11.9.0"
   			}
   		}
   	}
@@ -5391,6 +5590,28 @@
   		}
   	}
   };
+  var indoor = {
+  	floorplanFeaturesetId: {
+  		type: "string",
+  		doc: "An ID of a featureset to be used to query indoor floorplans.",
+  		experimental: true,
+  		transition: false,
+  		"property-type": "data-constant",
+  		expression: {
+  			interpolated: false
+  		}
+  	},
+  	buildingFeaturesetId: {
+  		type: "string",
+  		doc: "An ID of a featureset to be used to add interactivity for building selection.",
+  		experimental: true,
+  		transition: false,
+  		"property-type": "data-constant",
+  		expression: {
+  			interpolated: false
+  		}
+  	}
+  };
   var light = {
   	anchor: {
   		type: "enum",
@@ -6050,7 +6271,8 @@
   				"zoom",
   				"feature",
   				"feature-state",
-  				"measure-light"
+  				"measure-light",
+  				"line-progress"
   			]
   		},
   		"property-type": "data-driven"
@@ -8176,7 +8398,7 @@
   				doc: "The background is aligned to the plane of the map."
   			},
   			viewport: {
-  				doc: "The background is aligned to the plane of the viewport, covering the whole screen."
+  				doc: "The background is aligned to the plane of the viewport, covering the whole screen. Note: This mode disables the automatic reordering of the layer when terrain or globe projection is used."
   			}
   		},
   		"default": "map",
@@ -8193,6 +8415,7 @@
   			parameters: [
   			]
   		},
+  		experimental: true,
   		"property-type": "data-constant"
   	},
   	"background-color": {
@@ -8544,11 +8767,13 @@
   		"default": 1,
   		minimum: 0,
   		maximum: 1,
-  		doc: "The opacity of the model layer.",
+  		doc: "The opacity of the model layer. Except for zoom, expressions that are data-driven are not supported if using GeoJSON or vector tile as the model layer source.",
   		transition: true,
   		expression: {
   			interpolated: true,
   			parameters: [
+  				"feature",
+  				"feature-state",
   				"zoom"
   			]
   		},
@@ -8557,9 +8782,14 @@
   				js: "3.0.0",
   				android: "11.0.0",
   				ios: "11.0.0"
+  			},
+  			"data-driven styling": {
+  				js: "3.9.0",
+  				android: "11.9.0",
+  				ios: "11.9.0"
   			}
   		},
-  		"property-type": "data-constant"
+  		"property-type": "data-driven"
   	},
   	"model-rotation": {
   		type: "array",
@@ -8986,6 +9216,11 @@
   	data: {
   		type: "$root",
   		doc: "The inlined style that must correspond to the contents of the specified URL."
+  	},
+  	"color-theme": {
+  		type: "colorTheme",
+  		optional: true,
+  		doc: "If specified, it overrides the color-theme of the imported style."
   	}
   },
   	config: config,
@@ -9262,6 +9497,7 @@
   	rain: rain,
   	camera: camera,
   	colorTheme: colorTheme,
+  	indoor: indoor,
   	light: light,
   	projection: projection,
   	terrain: terrain,
@@ -11657,7 +11893,7 @@
      * var translucentGreen = new Color.parse('rgba(26, 207, 26, .73)');
      * translucentGreen.toString(); // = "rgba(26,207,26,0.73)"
      */
-      toString() {
+      toStringPremultipliedAlpha() {
           const [r, g, b, a] = this.a === 0 ? [
               0,
               0,
@@ -11671,10 +11907,22 @@
           ];
           return `rgba(${ Math.round(r) },${ Math.round(g) },${ Math.round(b) },${ a })`;
       }
+      toString() {
+          const [r, g, b, a] = [
+              this.r,
+              this.g,
+              this.b,
+              this.a
+          ];
+          return `rgba(${ Math.round(r * 255) },${ Math.round(g * 255) },${ Math.round(b * 255) },${ a })`;
+      }
       toRenderColor(lut) {
           const {r, g, b, a} = this;
           return new RenderColor(lut, r, g, b, a);
       }
+      clone() {
+          return new Color(this.r, this.g, this.b, this.a);
+      }
   }
   class RenderColor {
       constructor(lut, r, g, b, a) {
@@ -11736,6 +11984,53 @@
           ];
       }
       /**
+     * Returns an HSLA array of values representing the color, unpremultiplied by A.
+     *
+     * @returns An array of HSLA color values.
+     */
+      toHslaArray() {
+          if (this.a === 0) {
+              return [
+                  0,
+                  0,
+                  0,
+                  0
+              ];
+          }
+          const {r, g, b, a} = this;
+          const red = Math.min(Math.max(r / a, 0), 1);
+          const green = Math.min(Math.max(g / a, 0), 1);
+          const blue = Math.min(Math.max(b / a, 0), 1);
+          const min = Math.min(red, green, blue);
+          const max = Math.max(red, green, blue);
+          const l = (min + max) / 2;
+          if (min === max) {
+              return [
+                  0,
+                  0,
+                  l * 100,
+                  a
+              ];
+          }
+          const delta = max - min;
+          const s = l > 0.5 ? delta / (2 - max - min) : delta / (max + min);
+          let h = 0;
+          if (max === red) {
+              h = (green - blue) / delta + (green < blue ? 6 : 0);
+          } else if (max === green) {
+              h = (blue - red) / delta + 2;
+          } else if (max === blue) {
+              h = (red - green) / delta + 4;
+          }
+          h *= 60;
+          return [
+              Math.min(Math.max(h, 0), 360),
+              Math.min(Math.max(s * 100, 0), 100),
+              Math.min(Math.max(l * 100, 0), 100),
+              a
+          ];
+      }
+      /**
      * Returns a RGBA array of float values representing the color, unpremultiplied by A.
      *
      * @returns An array of RGBA color values in the range [0, 1].
@@ -11852,7 +12147,7 @@
       isEmpty() {
           if (this.sections.length === 0)
               return true;
-          return !this.sections.some(section => section.text.length !== 0 || section.image && section.image.namePrimary.length !== 0);
+          return !this.sections.some(section => section.text.length !== 0 || section.image && section.image.namePrimary);
       }
       static factory(text) {
           if (text instanceof Formatted) {
@@ -11896,42 +12191,113 @@
       }
   }
 
+  class ImageIdWithOptions {
+      constructor(id, options) {
+          this.id = id;
+          this.options = options || { params: {} };
+          if (!this.options.transform) {
+              this.options.transform = new DOMMatrix([
+                  1,
+                  0,
+                  0,
+                  1,
+                  0,
+                  0
+              ]);
+          } else {
+              const {a, b, c, d, e, f} = this.options.transform;
+              this.options.transform = new DOMMatrix([
+                  a,
+                  b,
+                  c,
+                  d,
+                  e,
+                  f
+              ]);
+          }
+      }
+      static deserializeFromString(serialized) {
+          const deserializedObject = JSON.parse(serialized);
+          ({ params: deserializedObject.options.params });
+          const {a, b, c, d, e, f} = deserializedObject.options.transform;
+          new DOMMatrix([
+              a,
+              b,
+              c,
+              d,
+              e,
+              f
+          ]);
+          return new ImageIdWithOptions(deserializedObject.id, deserializedObject.options);
+      }
+      scaleSelf(factor) {
+          this.options.transform = this.options.transform.scale(factor);
+          return this;
+      }
+      serialize() {
+          const serialisedObject = { id: this.id };
+          if (this.options) {
+              serialisedObject.options = this.options;
+          }
+          const {a, b, c, d, e, f} = this.options.transform;
+          serialisedObject.options.transform = {
+              a,
+              b,
+              c,
+              d,
+              e,
+              f
+          };
+          return JSON.stringify(serialisedObject);
+      }
+  }
+
   class ResolvedImage {
       constructor(options) {
           this.namePrimary = options.namePrimary;
           if (options.nameSecondary) {
               this.nameSecondary = options.nameSecondary;
           }
+          if (options.optionsPrimary) {
+              this.optionsPrimary = options.optionsPrimary;
+          }
+          if (options.optionsSecondary) {
+              this.optionsSecondary = options.optionsSecondary;
+          }
           this.available = options.available;
       }
       toString() {
-          if (this.nameSecondary) {
+          if (this.namePrimary && this.nameSecondary) {
               return `[${ this.namePrimary },${ this.nameSecondary }]`;
           }
           return this.namePrimary;
       }
-      static fromString(namePrimary, nameSecondary) {
+      getPrimary() {
+          return new ImageIdWithOptions(this.namePrimary, { params: this.optionsPrimary ? this.optionsPrimary.params || {} : {} });
+      }
+      getSerializedPrimary() {
+          return this.getPrimary().serialize();
+      }
+      getSecondary() {
+          if (this.nameSecondary) {
+              return new ImageIdWithOptions(this.nameSecondary, { params: this.optionsSecondary ? this.optionsSecondary.params || {} : {} });
+          }
+          return null;
+      }
+      static from(image) {
+          return typeof image === 'string' ? ResolvedImage.build(image) : image;
+      }
+      static build(namePrimary, nameSecondary, optionsPrimary, optionsSecondary) {
           if (!namePrimary)
               return null;
           return new ResolvedImage({
               namePrimary,
               nameSecondary,
+              optionsPrimary,
+              optionsSecondary,
               available: false
           });
       }
-      serialize() {
-          if (this.nameSecondary) {
-              return [
-                  'image',
-                  this.namePrimary,
-                  this.nameSecondary
-              ];
-          }
-          return [
-              'image',
-              this.namePrimary
-          ];
-      }
   }
 
   function validateRGBA(r, g, b, a) {
@@ -12072,7 +12438,9 @@
           return '';
       } else if (type === 'string' || type === 'number' || type === 'boolean') {
           return String(value);
-      } else if (value instanceof Color || value instanceof Formatted || value instanceof ResolvedImage) {
+      } else if (value instanceof Color) {
+          return value.toStringPremultipliedAlpha();
+      } else if (value instanceof Formatted || value instanceof ResolvedImage) {
           return value.toString();
       } else {
           return JSON.stringify(value);
@@ -12321,29 +12689,114 @@
       }
   }
 
+  function isImageOptions(value) {
+      if (typeof value !== 'string' && !isExpression(value)) {
+          return true;
+      }
+      return false;
+  }
   class ImageExpression {
-      constructor(inputPrimary, inputSecondary) {
+      constructor(inputPrimary, inputSecondary, inputPrimaryParams, inputSecondaryParams) {
+          this._imageWarnHistory = {};
           this.type = ResolvedImageType;
           this.inputPrimary = inputPrimary;
           this.inputSecondary = inputSecondary;
+          this.inputPrimaryParams = inputPrimaryParams;
+          this.inputSecondaryParams = inputSecondaryParams;
       }
       static parse(args, context) {
           if (args.length < 2) {
               return context.error(`Expected two or more arguments.`);
           }
-          const namePrimary = context.parse(args[1], 1, StringType);
-          if (!namePrimary)
-              return context.error(`No image name provided.`);
-          if (args.length === 2) {
-              return new ImageExpression(namePrimary);
+          let nextArgId = 1;
+          const imageExpression = [];
+          function tryParseImage() {
+              if (nextArgId < args.length) {
+                  const imageName = context.parse(args[nextArgId], nextArgId++, StringType);
+                  if (!imageName) {
+                      context.error(imageExpression.length ? `Secondary image variant is not a string.` : `No image name provided.`);
+                      return false;
+                  }
+                  imageExpression.push({
+                      image: imageName,
+                      options: void 0
+                  });
+                  return true;
+              }
+              return true;
           }
-          const nameSecondary = context.parse(args[2], 1, StringType);
-          if (!nameSecondary)
-              return context.error(`Secondary image variant is not a string.`);
-          return new ImageExpression(namePrimary, nameSecondary);
+          function tryParseOptions() {
+              if (nextArgId < args.length) {
+                  if (!isImageOptions(args[nextArgId])) {
+                      return true;
+                  }
+                  const params = args[nextArgId].params;
+                  const optionsContext = context.concat(nextArgId);
+                  if (!params) {
+                      nextArgId++;
+                      return true;
+                  }
+                  if (typeof params !== 'object' || params.constructor !== Object) {
+                      optionsContext.error(`Image options "params" should be an object`);
+                      return false;
+                  }
+                  const parsed = {};
+                  const childContext = optionsContext.concat(void 0, 'params');
+                  for (const key in params) {
+                      if (!key) {
+                          childContext.error(`Image parameter name should be non-empty`);
+                          return false;
+                      }
+                      const value = childContext.concat(void 0, key).parse(params[key], void 0, ColorType, void 0, { typeAnnotation: 'coerce' });
+                      if (!value) {
+                          return false;
+                      }
+                      parsed[key] = value;
+                  }
+                  imageExpression[imageExpression.length - 1].options = parsed;
+                  nextArgId++;
+                  return true;
+              }
+              return true;
+          }
+          for (let i = 0; i < 2; i++) {
+              if (!tryParseImage() || !tryParseOptions()) {
+                  return;
+              }
+          }
+          return new ImageExpression(imageExpression[0].image, imageExpression[1] ? imageExpression[1].image : void 0, imageExpression[0].options, imageExpression[1] ? imageExpression[1].options : void 0);
+      }
+      evaluateParams(ctx, params) {
+          const result = {};
+          if (params) {
+              for (const key in params) {
+                  if (params[key]) {
+                      try {
+                          const color = params[key].evaluate(ctx);
+                          const msg = `Ignoring image parameter "${ key }" with semi-transparent color ${ color.toString() }`;
+                          if (color.a !== 1) {
+                              if (!this._imageWarnHistory[msg]) {
+                                  console.warn(msg);
+                                  this._imageWarnHistory[msg] = true;
+                              }
+                              continue;
+                          }
+                          result[key] = color;
+                      } catch (err) {
+                          continue;
+                      }
+                  }
+              }
+          } else {
+              return void 0;
+          }
+          if (Object.keys(result).length === 0) {
+              return void 0;
+          }
+          return { params: result };
       }
       evaluate(ctx) {
-          const value = ResolvedImage.fromString(this.inputPrimary.evaluate(ctx), this.inputSecondary ? this.inputSecondary.evaluate(ctx) : void 0);
+          const value = ResolvedImage.build(this.inputPrimary.evaluate(ctx), this.inputSecondary ? this.inputSecondary.evaluate(ctx) : void 0, this.inputPrimaryParams ? this.evaluateParams(ctx, this.inputPrimaryParams) : void 0, this.inputSecondaryParams ? this.evaluateParams(ctx, this.inputSecondaryParams) : void 0);
           if (value && ctx.availableImages) {
               value.available = ctx.availableImages.indexOf(value.namePrimary) > -1;
               if (value.nameSecondary && value.available && ctx.availableImages) {
@@ -12354,25 +12807,55 @@
       }
       eachChild(fn) {
           fn(this.inputPrimary);
+          if (this.inputPrimaryParams) {
+              for (const key in this.inputPrimaryParams) {
+                  if (this.inputPrimaryParams[key]) {
+                      fn(this.inputPrimaryParams[key]);
+                  }
+              }
+          }
           if (this.inputSecondary) {
               fn(this.inputSecondary);
+              if (this.inputSecondaryParams) {
+                  for (const key in this.inputSecondaryParams) {
+                      if (this.inputSecondaryParams[key]) {
+                          fn(this.inputSecondaryParams[key]);
+                      }
+                  }
+              }
           }
       }
       outputDefined() {
           return false;
       }
-      serialize() {
-          if (this.inputSecondary) {
-              return [
-                  'image',
-                  this.inputPrimary.serialize(),
-                  this.inputSecondary.serialize()
-              ];
+      serializeParams(params) {
+          const result = {};
+          if (params) {
+              for (const key in params) {
+                  if (params[key]) {
+                      result[key] = params[key].serialize();
+                  }
+              }
+          } else {
+              return void 0;
           }
-          return [
+          return { params: result };
+      }
+      serialize() {
+          const serialized = [
               'image',
               this.inputPrimary.serialize()
           ];
+          if (this.inputPrimaryParams) {
+              serialized.push(this.serializeParams(this.inputPrimaryParams));
+          }
+          if (this.inputSecondary) {
+              serialized.push(this.inputSecondary.serialize());
+              if (this.inputSecondaryParams) {
+                  serialized.push(this.serializeParams(this.inputSecondaryParams));
+              }
+          }
+          return serialized;
       }
   }
 
@@ -12500,7 +12983,7 @@
           } else if (this.type.kind === 'formatted') {
               return Formatted.fromString(toString(this.args[0].evaluate(ctx)));
           } else if (this.type.kind === 'resolvedImage') {
-              return ResolvedImage.fromString(toString(this.args[0].evaluate(ctx)));
+              return ResolvedImage.build(toString(this.args[0].evaluate(ctx)));
           } else if (this.type.kind === 'array') {
               return this.args.map(arg => {
                   return arg.evaluate(ctx);
@@ -14254,7 +14737,7 @@
               return Formatted.fromString(toString(value));
           }
       case 'resolvedImage': {
-              return ResolvedImage.fromString(toString(value));
+              return ResolvedImage.build(toString(value));
           }
       }
       return value;
@@ -14912,11 +15395,12 @@
   });
 
   class Interpolate {
-      constructor(type, operator, interpolation, input, stops) {
+      constructor(type, operator, interpolation, input, dynamicStops, stops) {
           this.type = type;
           this.operator = operator;
           this.interpolation = interpolation;
           this.input = input;
+          this.dynamicStops = dynamicStops;
           this.labels = [];
           this.outputs = [];
           for (const [label, expression] of stops) {
@@ -14964,10 +15448,10 @@
           } else {
               return context.error(`Unknown interpolation type ${ String(interpolation[0]) }`, 1, 0);
           }
-          if (args.length - 1 < 4) {
-              return context.error(`Expected at least 4 arguments, but found only ${ args.length - 1 }.`);
+          if (args.length - 1 < 3) {
+              return context.error(`Expected at least 3 arguments, but found only ${ args.length - 1 }.`);
           }
-          if ((args.length - 1) % 2 !== 0) {
+          if (args.length - 1 > 3 && (args.length - 1) % 2 !== 0) {
               return context.error(`Expected an even number of arguments.`);
           }
           input = context.parse(input, 2, NumberType);
@@ -14980,6 +15464,12 @@
           } else if (context.expectedType && context.expectedType.kind !== 'value') {
               outputType = context.expectedType;
           }
+          if (args.length - 1 === 3) {
+              const dynamicStops = context.parse(rest[0], 3, ValueType);
+              if (!dynamicStops)
+                  return null;
+              return new Interpolate(outputType, operator, interpolation, input, dynamicStops, stops);
+          }
           for (let i = 0; i < rest.length; i += 2) {
               const label = rest[i];
               const value = rest[i + 1];
@@ -15003,11 +15493,34 @@
           if (outputType.kind !== 'number' && outputType.kind !== 'color' && !(outputType.kind === 'array' && outputType.itemType.kind === 'number' && typeof outputType.N === 'number')) {
               return context.error(`Type ${ toString$1(outputType) } is not interpolatable.`);
           }
-          return new Interpolate(outputType, operator, interpolation, input, stops);
+          return new Interpolate(outputType, operator, interpolation, input, null, stops);
       }
       evaluate(ctx) {
-          const labels = this.labels;
-          const outputs = this.outputs;
+          let labels = this.labels;
+          let outputs = this.outputs;
+          if (this.dynamicStops) {
+              const dynamicStopsValue = this.dynamicStops.evaluate(ctx);
+              if (dynamicStopsValue.length % 2 !== 0) {
+                  throw new RuntimeError('Expected an even number of arguments.');
+              }
+              labels = [];
+              outputs = [];
+              for (let i = 0; i < dynamicStopsValue.length; i += 2) {
+                  const label = dynamicStopsValue[i];
+                  const output = new Literal(NumberType, dynamicStopsValue[i + 1]);
+                  if (typeof label !== 'number') {
+                      throw new RuntimeError('Input/output pairs for "interpolate" expressions must be defined using literal numeric values (not computed expressions) for the input values.');
+                  }
+                  if (labels.length && labels[labels.length - 1] >= label) {
+                      throw new RuntimeError('Input/output pairs for "interpolate" expressions must be arranged with input values in strictly ascending order.');
+                  }
+                  labels.push(label);
+                  outputs.push(output);
+              }
+              if (labels.length === 0) {
+                  throw new RuntimeError('Expected at least one input/output pair.');
+              }
+          }
           if (labels.length === 1) {
               return outputs[0].evaluate(ctx);
           }
@@ -15063,8 +15576,12 @@
               interpolation,
               this.input.serialize()
           ];
-          for (let i = 0; i < this.labels.length; i++) {
-              serialized.push(this.labels[i], this.outputs[i].serialize());
+          if (this.dynamicStops) {
+              serialized.push(this.dynamicStops.serialize());
+          } else {
+              for (let i = 0; i < this.labels.length; i++) {
+                  serialized.push(this.labels[i], this.outputs[i].serialize());
+              }
           }
           return serialized;
       }
@@ -16052,6 +16569,13 @@
               return v.evaluate(ctx).toRenderColor(null).toArray();
           }
       ],
+      'to-hsla': [
+          array$1(NumberType, 4),
+          [ColorType],
+          (ctx, [v]) => {
+              return v.evaluate(ctx).toRenderColor(null).toHslaArray();
+          }
+      ],
       'rgb': [
           ColorType,
           [
@@ -16816,7 +17340,7 @@
       } else if (propertySpec.type === 'formatted') {
           input = Formatted.fromString(input.toString());
       } else if (propertySpec.type === 'resolvedImage') {
-          input = ResolvedImage.fromString(input.toString());
+          input = ResolvedImage.build(input.toString());
       } else if (getType(input) !== propertySpec.type && (propertySpec.type !== 'enum' || !propertySpec.values[input])) {
           input = void 0;
       }
@@ -16895,10 +17419,11 @@
       return success(new StyleExpression(parsed, propertySpec, scope, options));
   }
   class ZoomConstantExpression {
-      constructor(kind, expression, isLightConstant) {
+      constructor(kind, expression, isLightConstant, isLineProgressConstant) {
           this.kind = kind;
           this._styleExpression = expression;
           this.isLightConstant = isLightConstant;
+          this.isLineProgressConstant = isLineProgressConstant;
           this.isStateDependent = kind !== 'constant' && !isStateConstant(expression.expression);
           this.configDependencies = getConfigDependencies(expression.expression);
       }
@@ -16910,12 +17435,13 @@
       }
   }
   class ZoomDependentExpression {
-      constructor(kind, expression, zoomStops, interpolationType, isLightConstant) {
+      constructor(kind, expression, zoomStops, interpolationType, isLightConstant, isLineProgressConstant) {
           this.kind = kind;
           this.zoomStops = zoomStops;
           this._styleExpression = expression;
           this.isStateDependent = kind !== 'camera' && !isStateConstant(expression.expression);
           this.isLightConstant = isLightConstant;
+          this.isLineProgressConstant = isLineProgressConstant;
           this.configDependencies = getConfigDependencies(expression.expression);
           this.interpolationType = interpolationType;
       }
@@ -16970,13 +17496,13 @@
       }
       if (!zoomCurve) {
           return success(isFeatureConstant$1 && isLineProgressConstant ? // @ts-expect-error - TS2339 - Property 'value' does not exist on type 'unknown'.
-          new ZoomConstantExpression('constant', expression.value, isLightConstant) : // @ts-expect-error - TS2339 - Property 'value' does not exist on type 'unknown'.
-          new ZoomConstantExpression('source', expression.value, isLightConstant));
+          new ZoomConstantExpression('constant', expression.value, isLightConstant, isLineProgressConstant) : // @ts-expect-error - TS2339 - Property 'value' does not exist on type 'unknown'.
+          new ZoomConstantExpression('source', expression.value, isLightConstant, isLineProgressConstant));
       }
       const interpolationType = zoomCurve instanceof Interpolate ? zoomCurve.interpolation : void 0;
       return success(isFeatureConstant$1 && isLineProgressConstant ? // @ts-expect-error - TS2339 - Property 'value' does not exist on type 'unknown'.
-      new ZoomDependentExpression('camera', expression.value, zoomCurve.labels, interpolationType, isLightConstant) : // @ts-expect-error - TS2339 - Property 'value' does not exist on type 'unknown'.
-      new ZoomDependentExpression('composite', expression.value, zoomCurve.labels, interpolationType, isLightConstant));
+      new ZoomDependentExpression('camera', expression.value, zoomCurve.labels, interpolationType, isLightConstant, isLineProgressConstant) : // @ts-expect-error - TS2339 - Property 'value' does not exist on type 'unknown'.
+      new ZoomDependentExpression('composite', expression.value, zoomCurve.labels, interpolationType, isLightConstant, isLineProgressConstant));
   }
   class StylePropertyFunction {
       constructor(parameters, specification) {
@@ -18098,6 +18624,14 @@ ${ JSON.stringify(filterExp, null, 2) }
      */
       setFog: 'setFog',
       /*
+     *  { command: 'setSnow', args: [snowProperties] }
+     */
+      setSnow: 'setSnow',
+      /*
+     *  { command: 'setRain', args: [rainProperties] }
+     */
+      setRain: 'setRain',
+      /*
      *  { command: 'setCamera', args: [cameraProperties] }
      */
       setCamera: 'setCamera',
@@ -18498,6 +19032,18 @@ ${ JSON.stringify(filterExp, null, 2) }
                   args: [after.fog]
               });
           }
+          if (!deepEqual(before.snow, after.snow)) {
+              commands.push({
+                  command: operations.setSnow,
+                  args: [after.snow]
+              });
+          }
+          if (!deepEqual(before.rain, after.rain)) {
+              commands.push({
+                  command: operations.setRain,
+                  args: [after.rain]
+              });
+          }
           if (!deepEqual(before.projection, after.projection)) {
               commands.push({
                   command: operations.setProjection,
@@ -19109,6 +19655,16 @@ ${ JSON.stringify(filterExp, null, 2) }
       const layerSpec = styleSpec[`${ propertyType }_${ options.layerType }`];
       if (!layerSpec)
           return [];
+      const useThemeMatch = propertyKey.match(/^(.*)-use-theme$/);
+      if (propertyType === 'paint' && useThemeMatch && layerSpec[useThemeMatch[1]]) {
+          return validate({
+              key,
+              value,
+              valueSpec: { type: 'string' },
+              style,
+              styleSpec
+          });
+      }
       const transitionMatch = propertyKey.match(/^(.*)-transition$/);
       if (propertyType === 'paint' && transitionMatch && layerSpec[transitionMatch[1]] && layerSpec[transitionMatch[1]].transition) {
           return validate({
@@ -19483,7 +20039,16 @@ Use an identity property function instead: ${ example }.`)];
       }
       for (const key in light) {
           const transitionMatch = key.match(/^(.*)-transition$/);
-          if (transitionMatch && lightSpec[transitionMatch[1]] && lightSpec[transitionMatch[1]].transition) {
+          const useThemeMatch = key.match(/^(.*)-use-theme$/);
+          if (useThemeMatch && lightSpec[useThemeMatch[1]]) {
+              errors = errors.concat(validate({
+                  key,
+                  value: light[key],
+                  valueSpec: { type: 'string' },
+                  style,
+                  styleSpec
+              }));
+          } else if (transitionMatch && lightSpec[transitionMatch[1]] && lightSpec[transitionMatch[1]].transition) {
               errors = errors.concat(validate({
                   key,
                   value: light[key],
@@ -19569,7 +20134,16 @@ Use an identity property function instead: ${ example }.`)];
               }
           } else {
               const transitionMatch = key2.match(/^(.*)-transition$/);
-              if (transitionMatch && lightSpec[transitionMatch[1]] && lightSpec[transitionMatch[1]].transition) {
+              const useThemeMatch = key2.match(/^(.*)-use-theme$/);
+              if (useThemeMatch && lightSpec[useThemeMatch[1]]) {
+                  errors = errors.concat(validate({
+                      key: key2,
+                      value: light[key2],
+                      valueSpec: { type: 'string' },
+                      style,
+                      styleSpec
+                  }));
+              } else if (transitionMatch && lightSpec[transitionMatch[1]] && lightSpec[transitionMatch[1]].transition) {
                   errors = errors.concat(validate({
                       key: key2,
                       value: light[key2],
@@ -19611,7 +20185,16 @@ Use an identity property function instead: ${ example }.`)];
       }
       for (const key2 in terrain) {
           const transitionMatch = key2.match(/^(.*)-transition$/);
-          if (transitionMatch && terrainSpec[transitionMatch[1]] && terrainSpec[transitionMatch[1]].transition) {
+          const useThemeMatch = key2.match(/^(.*)-use-theme$/);
+          if (useThemeMatch && terrainSpec[useThemeMatch[1]]) {
+              errors = errors.concat(validate({
+                  key: key2,
+                  value: terrain[key2],
+                  valueSpec: { type: 'string' },
+                  style,
+                  styleSpec
+              }));
+          } else if (transitionMatch && terrainSpec[transitionMatch[1]] && terrainSpec[transitionMatch[1]].transition) {
               errors = errors.concat(validate({
                   key: key2,
                   value: terrain[key2],
@@ -19660,7 +20243,16 @@ Use an identity property function instead: ${ example }.`)];
       }
       for (const key in fog) {
           const transitionMatch = key.match(/^(.*)-transition$/);
-          if (transitionMatch && fogSpec[transitionMatch[1]] && fogSpec[transitionMatch[1]].transition) {
+          const useThemeMatch = key.match(/^(.*)-use-theme$/);
+          if (useThemeMatch && fogSpec[useThemeMatch[1]]) {
+              errors = errors.concat(validate({
+                  key,
+                  value: fog[key],
+                  valueSpec: { type: 'string' },
+                  style,
+                  styleSpec
+              }));
+          } else if (transitionMatch && fogSpec[transitionMatch[1]] && fogSpec[transitionMatch[1]].transition) {
               errors = errors.concat(validate({
                   key,
                   value: fog[key],