@mapbox/mapbox-gl-style-spec 14.11.0 → 14.12.0-beta.1

package/dist/index.d.ts

@@ -280,57 +280,114 @@ type FogSpecification = {
 	"vertical-range-transition"?: TransitionSpecification;
 };
 type SnowSpecification = {
+	/**
+	 * @experimental This property is experimental and subject to change in future versions.
+	 */
 	"density"?: PropertyValueSpecification<number>;
 	"density-transition"?: TransitionSpecification;
+	/**
+	 * @experimental This property is experimental and subject to change in future versions.
+	 */
 	"intensity"?: PropertyValueSpecification<number>;
 	"intensity-transition"?: TransitionSpecification;
+	/**
+	 * @experimental This property is experimental and subject to change in future versions.
+	 */
 	"color"?: PropertyValueSpecification<ColorSpecification>;
 	"color-transition"?: TransitionSpecification;
 	"color-use-theme"?: PropertyValueSpecification<string>;
+	/**
+	 * @experimental This property is experimental and subject to change in future versions.
+	 */
 	"opacity"?: PropertyValueSpecification<number>;
 	"opacity-transition"?: TransitionSpecification;
+	/**
+	 * @experimental This property is experimental and subject to change in future versions.
+	 */
 	"vignette"?: PropertyValueSpecification<number>;
 	"vignette-transition"?: TransitionSpecification;
+	/**
+	 * @experimental This property is experimental and subject to change in future versions.
+	 */
 	"vignette-color"?: PropertyValueSpecification<ColorSpecification>;
 	"vignette-color-transition"?: TransitionSpecification;
 	"vignette-color-use-theme"?: PropertyValueSpecification<string>;
+	/**
+	 * @experimental This property is experimental and subject to change in future versions.
+	 */
 	"center-thinning"?: PropertyValueSpecification<number>;
 	"center-thinning-transition"?: TransitionSpecification;
+	/**
+	 * @experimental This property is experimental and subject to change in future versions.
+	 */
 	"direction"?: PropertyValueSpecification<[
 		number,
 		number
 	]>;
 	"direction-transition"?: TransitionSpecification;
+	/**
+	 * @experimental This property is experimental and subject to change in future versions.
+	 */
 	"flake-size"?: PropertyValueSpecification<number>;
 	"flake-size-transition"?: TransitionSpecification;
 };
 type RainSpecification = {
+	/**
+	 * @experimental This property is experimental and subject to change in future versions.
+	 */
 	"density"?: PropertyValueSpecification<number>;
 	"density-transition"?: TransitionSpecification;
+	/**
+	 * @experimental This property is experimental and subject to change in future versions.
+	 */
 	"intensity"?: PropertyValueSpecification<number>;
 	"intensity-transition"?: TransitionSpecification;
+	/**
+	 * @experimental This property is experimental and subject to change in future versions.
+	 */
 	"color"?: PropertyValueSpecification<ColorSpecification>;
 	"color-transition"?: TransitionSpecification;
 	"color-use-theme"?: PropertyValueSpecification<string>;
+	/**
+	 * @experimental This property is experimental and subject to change in future versions.
+	 */
 	"opacity"?: PropertyValueSpecification<number>;
 	"opacity-transition"?: TransitionSpecification;
+	/**
+	 * @experimental This property is experimental and subject to change in future versions.
+	 */
 	"vignette"?: PropertyValueSpecification<number>;
 	"vignette-transition"?: TransitionSpecification;
+	/**
+	 * @experimental This property is experimental and subject to change in future versions.
+	 */
 	"vignette-color"?: PropertyValueSpecification<ColorSpecification>;
 	"vignette-color-transition"?: TransitionSpecification;
 	"vignette-color-use-theme"?: PropertyValueSpecification<string>;
+	/**
+	 * @experimental This property is experimental and subject to change in future versions.
+	 */
 	"center-thinning"?: PropertyValueSpecification<number>;
 	"center-thinning-transition"?: TransitionSpecification;
+	/**
+	 * @experimental This property is experimental and subject to change in future versions.
+	 */
 	"direction"?: PropertyValueSpecification<[
 		number,
 		number
 	]>;
 	"direction-transition"?: TransitionSpecification;
+	/**
+	 * @experimental This property is experimental and subject to change in future versions.
+	 */
 	"droplet-size"?: PropertyValueSpecification<[
 		number,
 		number
 	]>;
 	"droplet-size-transition"?: TransitionSpecification;
+	/**
+	 * @experimental This property is experimental and subject to change in future versions.
+	 */
 	"distortion-strength"?: PropertyValueSpecification<number>;
 	"distortion-strength-transition"?: TransitionSpecification;
 };
@@ -666,11 +723,20 @@ type FillLayerSpecification = {
 		"fill-pattern"?: DataDrivenPropertyValueSpecification<ResolvedImageSpecification>;
 		"fill-emissive-strength"?: PropertyValueSpecification<number>;
 		"fill-emissive-strength-transition"?: TransitionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
 		"fill-z-offset"?: DataDrivenPropertyValueSpecification<number>;
 		"fill-z-offset-transition"?: TransitionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
 		"fill-bridge-guard-rail-color"?: DataDrivenPropertyValueSpecification<ColorSpecification>;
 		"fill-bridge-guard-rail-color-transition"?: TransitionSpecification;
 		"fill-bridge-guard-rail-color-use-theme"?: PropertyValueSpecification<string>;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
 		"fill-tunnel-structure-color"?: DataDrivenPropertyValueSpecification<ColorSpecification>;
 		"fill-tunnel-structure-color-transition"?: TransitionSpecification;
 		"fill-tunnel-structure-color-use-theme"?: PropertyValueSpecification<string>;
@@ -745,6 +811,9 @@ type LineLayerSpecification = {
 			number,
 			number
 		]>;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
 		"line-trim-color"?: PropertyValueSpecification<ColorSpecification>;
 		"line-trim-color-transition"?: TransitionSpecification;
 		"line-trim-color-use-theme"?: PropertyValueSpecification<string>;
@@ -888,6 +957,9 @@ type SymbolLayerSpecification = {
 		"icon-color-contrast"?: ExpressionSpecification;
 		"icon-color-brightness-min"?: ExpressionSpecification;
 		"icon-color-brightness-max"?: ExpressionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
 		"symbol-z-offset"?: DataDrivenPropertyValueSpecification<number>;
 		"symbol-z-offset-transition"?: TransitionSpecification;
 	};
@@ -1011,23 +1083,50 @@ type FillExtrusionLayerSpecification = {
 		"fill-extrusion-ambient-occlusion-intensity-transition"?: TransitionSpecification;
 		"fill-extrusion-ambient-occlusion-radius"?: PropertyValueSpecification<number>;
 		"fill-extrusion-ambient-occlusion-radius-transition"?: TransitionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
 		"fill-extrusion-ambient-occlusion-wall-radius"?: PropertyValueSpecification<number>;
 		"fill-extrusion-ambient-occlusion-wall-radius-transition"?: TransitionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
 		"fill-extrusion-ambient-occlusion-ground-radius"?: PropertyValueSpecification<number>;
 		"fill-extrusion-ambient-occlusion-ground-radius-transition"?: TransitionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
 		"fill-extrusion-ambient-occlusion-ground-attenuation"?: PropertyValueSpecification<number>;
 		"fill-extrusion-ambient-occlusion-ground-attenuation-transition"?: TransitionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
 		"fill-extrusion-flood-light-color"?: PropertyValueSpecification<ColorSpecification>;
 		"fill-extrusion-flood-light-color-transition"?: TransitionSpecification;
 		"fill-extrusion-flood-light-color-use-theme"?: PropertyValueSpecification<string>;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
 		"fill-extrusion-flood-light-intensity"?: PropertyValueSpecification<number>;
 		"fill-extrusion-flood-light-intensity-transition"?: TransitionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
 		"fill-extrusion-flood-light-wall-radius"?: DataDrivenPropertyValueSpecification<number>;
 		"fill-extrusion-flood-light-wall-radius-transition"?: TransitionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
 		"fill-extrusion-flood-light-ground-radius"?: DataDrivenPropertyValueSpecification<number>;
 		"fill-extrusion-flood-light-ground-radius-transition"?: TransitionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
 		"fill-extrusion-flood-light-ground-attenuation"?: PropertyValueSpecification<number>;
 		"fill-extrusion-flood-light-ground-attenuation-transition"?: TransitionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
 		"fill-extrusion-vertical-scale"?: PropertyValueSpecification<number>;
 		"fill-extrusion-vertical-scale-transition"?: TransitionSpecification;
 		/**
@@ -1037,11 +1136,87 @@ type FillExtrusionLayerSpecification = {
 		"fill-extrusion-cutoff-fade-range"?: ExpressionSpecification;
 		"fill-extrusion-emissive-strength"?: DataDrivenPropertyValueSpecification<number>;
 		"fill-extrusion-emissive-strength-transition"?: TransitionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
 		"fill-extrusion-line-width"?: DataDrivenPropertyValueSpecification<number>;
 		"fill-extrusion-line-width-transition"?: TransitionSpecification;
 		"fill-extrusion-cast-shadows"?: boolean;
 	};
 };
+type BuildingLayerSpecification = {
+	"id": string;
+	"type": "building";
+	"metadata"?: unknown;
+	"source": string;
+	"source-layer"?: string;
+	"slot"?: string;
+	"minzoom"?: number;
+	"maxzoom"?: number;
+	"filter"?: FilterSpecification;
+	"layout"?: {
+		"visibility"?: "visible" | "none" | ExpressionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
+		"building-roof-shape"?: DataDrivenPropertyValueSpecification<"flat" | "hipped" | "gabled" | "parapet" | "mansard" | "skillion" | "pyramidal">;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
+		"building-height"?: DataDrivenPropertyValueSpecification<number>;
+		"building-height-transition"?: TransitionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
+		"building-base"?: DataDrivenPropertyValueSpecification<number>;
+		"building-base-transition"?: TransitionSpecification;
+	};
+	"paint"?: {
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
+		"building-opacity"?: PropertyValueSpecification<number>;
+		"building-opacity-transition"?: TransitionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
+		"building-ambient-occlusion-wall-intensity"?: PropertyValueSpecification<number>;
+		"building-ambient-occlusion-wall-intensity-transition"?: TransitionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
+		"building-ambient-occlusion-ground-intensity"?: PropertyValueSpecification<number>;
+		"building-ambient-occlusion-ground-intensity-transition"?: TransitionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
+		"building-ambient-occlusion-ground-radius"?: PropertyValueSpecification<number>;
+		"building-ambient-occlusion-ground-radius-transition"?: TransitionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
+		"building-ambient-occlusion-ground-attenuation"?: PropertyValueSpecification<number>;
+		"building-ambient-occlusion-ground-attenuation-transition"?: TransitionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
+		"building-vertical-scale"?: PropertyValueSpecification<number>;
+		"building-vertical-scale-transition"?: TransitionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
+		"building-cast-shadows"?: boolean;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
+		"building-color"?: DataDrivenPropertyValueSpecification<ColorSpecification>;
+		"building-color-use-theme"?: PropertyValueSpecification<string>;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
+		"building-emissive-strength"?: DataDrivenPropertyValueSpecification<number>;
+	};
+};
 type RasterLayerSpecification = {
 	"id": string;
 	"type": "raster";
@@ -1090,6 +1265,9 @@ type RasterLayerSpecification = {
 		 * @experimental This property is experimental and subject to change in future versions.
 		 */
 		"raster-array-band"?: string;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
 		"raster-elevation"?: PropertyValueSpecification<number>;
 		"raster-elevation-transition"?: TransitionSpecification;
 	};
@@ -1310,7 +1488,7 @@ type ClipLayerSpecification = {
 	};
 	"paint"?: never;
 };
-type LayerSpecification = FillLayerSpecification | LineLayerSpecification | SymbolLayerSpecification | CircleLayerSpecification | HeatmapLayerSpecification | FillExtrusionLayerSpecification | RasterLayerSpecification | RasterParticleLayerSpecification | HillshadeLayerSpecification | ModelLayerSpecification | BackgroundLayerSpecification | SkyLayerSpecification | SlotLayerSpecification | ClipLayerSpecification;
+type LayerSpecification = FillLayerSpecification | LineLayerSpecification | SymbolLayerSpecification | CircleLayerSpecification | HeatmapLayerSpecification | FillExtrusionLayerSpecification | BuildingLayerSpecification | RasterLayerSpecification | RasterParticleLayerSpecification | HillshadeLayerSpecification | ModelLayerSpecification | BackgroundLayerSpecification | SkyLayerSpecification | SlotLayerSpecification | ClipLayerSpecification;
 /**
  * Given an array of layers, some of which may contain `ref` properties
  * whose value is the `id` of another property, return a new array where
@@ -1678,12 +1856,12 @@ declare class EvaluationContext {
 		[_: string]: Color | null | undefined;
 	};
 	constructor(scope?: string | null, options?: ConfigOptions | null);
-	id(): number | null;
+	id(): string | number | null;
 	geometryType(): null | string;
 	geometry(): Array<Array<Point>> | null | undefined;
 	canonicalID(): null | CanonicalTileID;
 	properties(): {
-		[key: string]: any;
+		readonly [key: string]: unknown;
 	};
 	measureLight(_: string): number;
 	distanceFromCenter(): number;
@@ -1713,13 +1891,9 @@ type InterpolationType = {
 };
 interface Feature {
 	readonly type: 0 | 1 | 2 | 3 | "Unknown" | "Point" | "LineString" | "Polygon";
-	readonly id?: number | null;
-	readonly properties: {
-		[_: string]: any;
-	};
-	readonly patterns?: {
-		[_: string]: string;
-	};
+	readonly id?: string | number | null;
+	readonly properties: Record<PropertyKey, unknown>;
+	readonly patterns?: Record<PropertyKey, string>;
 	readonly geometry?: Array<Array<Point>>;
 }
 type FeatureState = {