@mapbox/mapbox-gl-style-spec 14.5.2 → 14.6.0

package/dist/index.d.ts

@@ -45,7 +45,7 @@ type ResolvedImageSpecification = string;
 type PromoteIdSpecification = {
 	[_: string]: string;
 } | string;
-type FilterSpecification = [
+type FilterSpecification = ExpressionSpecification | [
 	"has",
 	string
 ] | [
@@ -180,7 +180,7 @@ type ExpressionSpecification = [
 	...any[]
 ];
 type PropertyValueSpecification<T> = T | CameraFunctionSpecification<T> | ExpressionSpecification;
-type DataDrivenPropertyValueSpecification<T> = T | FunctionSpecification<T> | CameraFunctionSpecification<T> | SourceFunctionSpecification<T> | CompositeFunctionSpecification<T> | ExpressionSpecification;
+type DataDrivenPropertyValueSpecification<T> = T | FunctionSpecification<T> | CameraFunctionSpecification<T> | SourceFunctionSpecification<T> | CompositeFunctionSpecification<T> | ExpressionSpecification | (T extends Array<infer U> ? Array<U | ExpressionSpecification> : never);
 type StyleSpecification = {
 	"version": 8;
 	"fragment"?: boolean;
@@ -824,6 +824,9 @@ type FillExtrusionLayerSpecification = {
 		"fill-extrusion-cutoff-fade-range"?: ExpressionSpecification;
 		"fill-extrusion-emissive-strength"?: PropertyValueSpecification<number>;
 		"fill-extrusion-emissive-strength-transition"?: TransitionSpecification;
+		"fill-extrusion-line-width"?: DataDrivenPropertyValueSpecification<number>;
+		"fill-extrusion-line-width-transition"?: TransitionSpecification;
+		"fill-extrusion-line-alignment"?: "inside" | "outside" | "center";
 	};
 };
 type RasterLayerSpecification = {
@@ -900,6 +903,8 @@ type RasterParticleLayerSpecification = {
 		"raster-particle-fade-opacity-factor"?: PropertyValueSpecification<number>;
 		"raster-particle-fade-opacity-factor-transition"?: TransitionSpecification;
 		"raster-particle-reset-rate-factor"?: number;
+		"raster-particle-elevation"?: PropertyValueSpecification<number>;
+		"raster-particle-elevation-transition"?: TransitionSpecification;
 	};
 };
 type HillshadeLayerSpecification = {
@@ -970,8 +975,8 @@ type ModelLayerSpecification = {
 		"model-color-mix-intensity"?: DataDrivenPropertyValueSpecification<number>;
 		"model-color-mix-intensity-transition"?: TransitionSpecification;
 		"model-type"?: "common-3d" | "location-indicator";
-		"model-cast-shadows"?: ExpressionSpecification;
-		"model-receive-shadows"?: ExpressionSpecification;
+		"model-cast-shadows"?: boolean;
+		"model-receive-shadows"?: boolean;
 		"model-ambient-occlusion-intensity"?: PropertyValueSpecification<number>;
 		"model-ambient-occlusion-intensity-transition"?: TransitionSpecification;
 		"model-emissive-strength"?: DataDrivenPropertyValueSpecification<number>;
@@ -1077,6 +1082,10 @@ type ClipLayerSpecification = {
 		 * @experimental This property is experimental and subject to change in future versions.
 		 */
 		"clip-layer-types"?: ExpressionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
+		"clip-layer-scope"?: ExpressionSpecification;
 	};
 	"paint"?: never;
 };
@@ -1364,7 +1373,7 @@ declare function isExpressionFilter(filter: unknown): boolean;
  * @param {string} layerType the type of the layer this filter will be applied to.
  * @returns {Function} filter-evaluating function
  */
-declare function createFilter(filter?: FilterSpecification | ExpressionSpecification, layerType?: string): FeatureFilter;
+declare function createFilter(filter?: FilterSpecification, layerType?: string): FeatureFilter;
 type SerializedExpression = Array<unknown> | Array<string> | string | number | boolean | null;
 interface Expression {
 	readonly type: Type;
@@ -1481,7 +1490,7 @@ declare function createExpression(expression: unknown, propertySpec?: StylePrope
 declare class ZoomConstantExpression<Kind extends EvaluationKind> {
 	kind: Kind;
 	isStateDependent: boolean;
-	isConfigDependent: boolean;
+	configDependencies: Set<string>;
 	_styleExpression: StyleExpression;
 	isLightConstant: boolean | null | undefined;
 	constructor(kind: Kind, expression: StyleExpression, isLightConstant?: boolean | null);
@@ -1493,7 +1502,7 @@ declare class ZoomDependentExpression<Kind extends EvaluationKind> {
 	zoomStops: Array<number>;
 	isStateDependent: boolean;
 	isLightConstant: boolean | null | undefined;
-	isConfigDependent: boolean;
+	configDependencies: Set<string>;
 	_styleExpression: StyleExpression;
 	interpolationType: InterpolationType | null | undefined;
 	constructor(kind: Kind, expression: StyleExpression, zoomStops: Array<number>, interpolationType?: InterpolationType, isLightConstant?: boolean | null);
@@ -1503,20 +1512,20 @@ declare class ZoomDependentExpression<Kind extends EvaluationKind> {
 }
 type ConstantExpression = {
 	kind: "constant";
-	isConfigDependent: boolean;
+	configDependencies: Set<string>;
 	readonly evaluate: (globals: GlobalProperties, feature?: Feature, featureState?: FeatureState, canonical?: CanonicalTileID, availableImages?: Array<string>) => any;
 };
 type SourceExpression = {
 	kind: "source";
 	isStateDependent: boolean;
 	isLightConstant: boolean | null | undefined;
-	isConfigDependent: boolean;
+	configDependencies: Set<string>;
 	readonly evaluate: (globals: GlobalProperties, feature?: Feature, featureState?: FeatureState, canonical?: CanonicalTileID, availableImages?: Array<string>, formattedSection?: FormattedSection) => any;
 };
 type CameraExpression = {
 	kind: "camera";
 	isStateDependent: boolean;
-	isConfigDependent: boolean;
+	configDependencies: Set<string>;
 	readonly evaluate: (globals: GlobalProperties, feature?: Feature, featureState?: FeatureState, canonical?: CanonicalTileID, availableImages?: Array<string>) => any;
 	readonly interpolationFactor: (input: number, lower: number, upper: number) => number;
 	zoomStops: Array<number>;
@@ -1526,7 +1535,7 @@ interface CompositeExpression {
 	kind: "composite";
 	isStateDependent: boolean;
 	isLightConstant: boolean | null | undefined;
-	isConfigDependent: boolean;
+	configDependencies: Set<string>;
 	readonly evaluate: (globals: GlobalProperties, feature?: Feature, featureState?: FeatureState, canonical?: CanonicalTileID, availableImages?: Array<string>, formattedSection?: FormattedSection) => any;
 	readonly interpolationFactor: (input: number, lower: number, upper: number) => number;
 	zoomStops: Array<number>;

package/dist/index.es.js

@@ -1440,6 +1440,25 @@ var layout_clip = {
 		},
 		"property-type": "data-constant",
 		experimental: true
+	},
+	"clip-layer-scope": {
+		type: "array",
+		value: "string",
+		"default": [
+		],
+		doc: "Removes content from layers with the specified scope. By default all layers are affected. For example specifying `basemap` will only remove content from the Mapbox Standard style layers which have the same scope",
+		"sdk-support": {
+			"basic functionality": {
+				js: "3.6.0",
+				android: "11.7.0",
+				ios: "11.7.0"
+			}
+		},
+		expression: {
+			interpolated: false
+		},
+		"property-type": "data-constant",
+		experimental: true
 	}
 };
 var layout_fill = {
@@ -5763,7 +5782,6 @@ var paint_line = {
 		"default": 0,
 		minimum: 0,
 		maximum: 1,
-		experimental: true,
 		doc: "Opacity multiplier (multiplies line-opacity value) of the line part that is occluded by 3D objects. Value 0 hides occluded part, value 1 means the same opacity as non-occluded part. The property is not supported when `line-opacity` has data-driven styling.",
 		"sdk-support": {
 			"basic functionality": {
@@ -5844,7 +5862,7 @@ var paint_circle = {
 	"circle-blur": {
 		type: "number",
 		"default": 0,
-		doc: "Amount to blur the circle. 1 blurs the circle such that only the centerpoint is full opacity.",
+		doc: "Amount to blur the circle. 1 blurs the circle such that only the centerpoint is full opacity. Setting a negative value renders the blur as an inner glow effect.",
 		transition: true,
 		"sdk-support": {
 			"basic functionality": {
@@ -6305,11 +6323,11 @@ var paint_symbol = {
 		"property-type": "data-driven"
 	},
 	"icon-occlusion-opacity": {
-		doc: "The opacity at which the icon will be drawn in case of being depth occluded. Not supported on globe zoom levels. Absent value means behavior prior to this property introduction.",
+		doc: "The opacity at which the icon will be drawn in case of being depth occluded. Absent value means full occlusion against terrain only.",
 		type: "number",
 		minimum: 0,
 		maximum: 1,
-		"default": 1,
+		"default": 0,
 		transition: true,
 		requires: [
 			"icon-image"
@@ -6655,10 +6673,10 @@ var paint_symbol = {
 	},
 	"text-occlusion-opacity": {
 		type: "number",
-		doc: "The opacity at which the text will be drawn in case of being depth occluded. Not supported on globe zoom levels. Absent value means behavior prior to this property introduction.",
+		doc: "The opacity at which the text will be drawn in case of being depth occluded. Absent value means full occlusion against terrain only.",
 		minimum: 0,
 		maximum: 1,
-		"default": 1,
+		"default": 0,
 		transition: true,
 		requires: [
 			"text-field"
@@ -8002,9 +8020,6 @@ var paint_model = {
 		"default": true,
 		doc: "Enable/Disable shadow casting for this layer",
 		transition: false,
-		expression: {
-			interpolated: false
-		},
 		"sdk-support": {
 			"basic functionality": {
 				js: "3.0.0",
@@ -8019,9 +8034,6 @@ var paint_model = {
 		"default": true,
 		doc: "Enable/Disable shadow receiving for this layer",
 		transition: false,
-		expression: {
-			interpolated: false
-		},
 		"sdk-support": {
 			"basic functionality": {
 				js: "3.0.0",
@@ -9083,6 +9095,57 @@ var v8 = {
 			]
 		},
 		"property-type": "data-constant"
+	},
+	"fill-extrusion-line-width": {
+		type: "number",
+		"default": 0,
+		minimum: 0,
+		transition: true,
+		units: "meters",
+		doc: "If a non-zero value is provided, it sets the fill-extrusion layer into wall rendering mode. The value is used to render the feature with the given width over the outlines of the geometry. Note: This property is experimental and some other fill-extrusion properties might not be supported with non-zero line width.",
+		"sdk-support": {
+			"basic functionality": {
+				js: "3.7.0"
+			},
+			"data-driven styling": {
+				js: "3.7.0"
+			}
+		},
+		expression: {
+			interpolated: true,
+			parameters: [
+				"zoom",
+				"feature",
+				"feature-state",
+				"measure-light"
+			]
+		},
+		"property-type": "data-driven"
+	},
+	"fill-extrusion-line-alignment": {
+		type: "enum",
+		values: {
+			inside: {
+				doc: "Aligns the wall inside of the outline."
+			},
+			outside: {
+				doc: "Aligns the wall outside of the outline."
+			},
+			center: {
+				doc: "Aligns the wall relative to the center of the outline."
+			}
+		},
+		"default": "center",
+		doc: "Specifies the alignment for offset of the walls relative to the outlines of the geometry. For open-ended line string geometries the positioning is considered based on the ordering of the points, where inside is in clockwise order and outside is counter-clockwise. This property only has an effect if a non-zero fill-extrusion-line-width is used. Center alignment is automatically used for non-closed lines.",
+		requires: [
+			"fill-extrusion-line-width"
+		],
+		"sdk-support": {
+			"basic functionality": {
+				js: "3.7.0"
+			}
+		},
+		"property-type": "data-constant"
 	}
 },
 	paint_line: paint_line,
@@ -9216,6 +9279,27 @@ var v8 = {
 			}
 		},
 		"property-type": "data-constant"
+	},
+	"raster-particle-elevation": {
+		type: "number",
+		doc: "Specifies an uniform elevation from the ground, in meters.",
+		"default": 0,
+		minimum: 0,
+		transition: true,
+		"sdk-support": {
+			"basic functionality": {
+				js: "3.7.0",
+				android: "11.7.0",
+				ios: "11.7.0"
+			}
+		},
+		expression: {
+			interpolated: true,
+			parameters: [
+				"zoom"
+			]
+		},
+		"property-type": "data-constant"
 	}
 },
 	paint_hillshade: paint_hillshade,
@@ -11301,7 +11385,7 @@ class Assertion {
             if (!error) {
                 return value;
             } else if (i === this.args.length - 1) {
-                throw new RuntimeError(`Expected value to be of type ${ toString$1(this.type) }, but found ${ toString$1(typeOf(value)) } instead.`);
+                throw new RuntimeError(`The expression ${ JSON.stringify(this.args[i].serialize()) } evaluated to ${ toString$1(typeOf(value)) } but was expected to be of type ${ toString$1(this.type) }.`);
             }
         }
         return null;
@@ -13800,15 +13884,20 @@ function isStateConstant(e) {
     });
     return result;
 }
-function isConfigConstant(e) {
+function getConfigDependencies(e) {
     if (e instanceof Config) {
-        return false;
+        const singleConfig = /* @__PURE__ */
+        new Set([e.key]);
+        return singleConfig;
     }
-    let result = true;
+    let result = /* @__PURE__ */
+    new Set();
     e.eachChild(arg => {
-        if (result && !isConfigConstant(arg)) {
-            result = false;
-        }
+        result = /* @__PURE__ */
+        new Set([
+            ...result,
+            ...getConfigDependencies(arg)
+        ]);
     });
     return result;
 }
@@ -16236,7 +16325,7 @@ class StyleExpression {
             if (!this._warningHistory[e.message]) {
                 this._warningHistory[e.message] = true;
                 if (typeof console !== 'undefined') {
-                    console.warn(e.message);
+                    console.warn(`Failed to evaluate expression "${ JSON.stringify(this.expression.serialize()) }". ${ e.message }`);
                 }
             }
             return this._defaultValue;
@@ -16260,7 +16349,7 @@ class ZoomConstantExpression {
         this._styleExpression = expression;
         this.isLightConstant = isLightConstant;
         this.isStateDependent = kind !== 'constant' && !isStateConstant(expression.expression);
-        this.isConfigDependent = !isConfigConstant(expression.expression);
+        this.configDependencies = getConfigDependencies(expression.expression);
     }
     evaluateWithoutErrorHandling(globals, feature, featureState, canonical, availableImages, formattedSection) {
         return this._styleExpression.evaluateWithoutErrorHandling(globals, feature, featureState, canonical, availableImages, formattedSection);
@@ -16276,7 +16365,7 @@ class ZoomDependentExpression {
         this._styleExpression = expression;
         this.isStateDependent = kind !== 'camera' && !isStateConstant(expression.expression);
         this.isLightConstant = isLightConstant;
-        this.isConfigDependent = !isConfigConstant(expression.expression);
+        this.configDependencies = getConfigDependencies(expression.expression);
         this.interpolationType = interpolationType;
     }
     evaluateWithoutErrorHandling(globals, feature, featureState, canonical, availableImages, formattedSection) {
@@ -16366,7 +16455,8 @@ function normalizePropertyExpression(value, specification, scope, options) {
         }
         return {
             kind: 'constant',
-            isConfigDependent: false,
+            configDependencies: /* @__PURE__ */
+            new Set(),
             evaluate: () => constant
         };
     }
@@ -17195,8 +17285,7 @@ function convertInOp(property, values, negate = false) {
             negate
         ];
     }
-    return [negate ? 'all' : 'any'].concat(// @ts-expect-error - TS2769 - No overload matches this call.
-    values.map(v => [
+    return [negate ? 'all' : 'any'].concat(values.map(v => [
         negate ? '!=' : '==',
         get,
         v