@mapbox/mapbox-gl-style-spec 14.20.0 → 14.21.0

package/dist/index.d.ts

@@ -926,6 +926,10 @@ export type LineLayerSpecification = {
 		"line-border-color-use-theme"?: PropertyValueSpecification<string>;
 		"line-occlusion-opacity"?: PropertyValueSpecification<number>;
 		"line-occlusion-opacity-transition"?: TransitionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
+		"line-blend-mode"?: PropertyValueSpecification<"default" | "multiply" | "additive">;
 	};
 	/**
 	 * @experimental This property is experimental and subject to change in future versions.
@@ -1206,6 +1210,10 @@ export type FillExtrusionLayerSpecification = {
 		 * @experimental This property is experimental and subject to change in future versions.
 		 */
 		"fill-extrusion-edge-radius"?: number | ExpressionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
+		"source-max-zoom"?: number;
 	};
 	"paint"?: {
 		"fill-extrusion-opacity"?: PropertyValueSpecification<number>;
@@ -1289,6 +1297,14 @@ export type FillExtrusionLayerSpecification = {
 		 */
 		"fill-extrusion-rounded-roof"?: PropertyValueSpecification<boolean>;
 		"fill-extrusion-cutoff-fade-range"?: number | ExpressionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
+		"fill-extrusion-front-cutoff"?: PropertyValueSpecification<[
+			number,
+			number,
+			number
+		]>;
 		"fill-extrusion-emissive-strength"?: DataDrivenPropertyValueSpecification<number>;
 		"fill-extrusion-emissive-strength-transition"?: TransitionSpecification;
 		/**
@@ -1361,6 +1377,14 @@ export type BuildingLayerSpecification = {
 		"building-emissive-strength"?: DataDrivenPropertyValueSpecification<number>;
 		"building-facade-emissive-chance"?: PropertyValueSpecification<number>;
 		"building-cutoff-fade-range"?: number | ExpressionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
+		"building-front-cutoff"?: PropertyValueSpecification<[
+			number,
+			number,
+			number
+		]>;
 		"building-flood-light-color"?: PropertyValueSpecification<ColorSpecification>;
 		"building-flood-light-color-transition"?: TransitionSpecification;
 		"building-flood-light-color-use-theme"?: PropertyValueSpecification<string>;
@@ -1604,6 +1628,10 @@ export type ModelLayerSpecification = {
 			number
 		]>;
 		"model-elevation-reference"?: "sea" | "ground" | "hd-road-markup" | ExpressionSpecification;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
+		"model-ignore-line-cutout"?: boolean | ExpressionSpecification;
 	};
 	/**
 	 * @experimental This property is experimental and subject to change in future versions.

package/dist/index.es.js

@@ -7433,6 +7433,44 @@ var paint_building = {
 		},
 		"property-type": "data-constant"
 	},
+	"building-front-cutoff": {
+		type: "array",
+		"private": true,
+		experimental: true,
+		value: "number",
+		"property-type": "data-constant",
+		transition: false,
+		expression: {
+			interpolated: true,
+			parameters: [
+				"zoom"
+			]
+		},
+		length: 3,
+		"default": [
+			0,
+			0,
+			1
+		],
+		minimum: [
+			0,
+			0,
+			0
+		],
+		maximum: [
+			1,
+			1,
+			1
+		],
+		doc: "An array for configuring the fade-out effect for the front cutoff of content on pitched map views. It contains three values: start, range and final opacity. The start parameter defines the point at which the fade-out effect begins, with smaller values causing the effect to start earlier. The range parameter specifies how long the fade-out effect will last. A value of 0.0 for range makes content disappear immediately without a fade-out effect. The final opacity determines content opacity at the end of the fade-out effect. A value of 1.0 for final opacity means that the cutoff is completely disabled. Note: The property has no effect on the map if terrain or globe projection is enabled.",
+		"sdk-support": {
+			"basic functionality": {
+				js: "3.21.0",
+				android: "11.21.0",
+				ios: "11.21.0"
+			}
+		}
+	},
 	"building-flood-light-color": {
 		"property-type": "data-constant",
 		type: "color",
@@ -8110,6 +8148,36 @@ var paint_line = {
 		},
 		transition: true,
 		"property-type": "data-constant"
+	},
+	"line-blend-mode": {
+		type: "enum",
+		values: {
+			"default": {
+				doc: "Normal non-blended rendering mode."
+			},
+			multiply: {
+				doc: "Line features are composited using multiply blending."
+			},
+			additive: {
+				doc: "Line features are composited using additive density accumulation with tone mapping."
+			}
+		},
+		doc: "Controls the blend mode used for rendering line features.",
+		"default": "default",
+		experimental: true,
+		"private": true,
+		"sdk-support": {
+			"basic functionality": {
+				js: "3.21.0"
+			}
+		},
+		expression: {
+			interpolated: false,
+			parameters: [
+				"zoom"
+			]
+		},
+		"property-type": "data-constant"
 	}
 };
 var paint_circle = {
@@ -8635,6 +8703,7 @@ var paint_symbol = {
 				"measure-light"
 			]
 		},
+		appearance: true,
 		"property-type": "data-driven"
 	},
 	"icon-occlusion-opacity": {
@@ -8668,6 +8737,7 @@ var paint_symbol = {
 				"measure-light"
 			]
 		},
+		appearance: true,
 		"property-type": "data-driven"
 	},
 	"icon-emissive-strength": {
@@ -8700,6 +8770,7 @@ var paint_symbol = {
 				"feature-state"
 			]
 		},
+		appearance: true,
 		"property-type": "data-driven"
 	},
 	"text-emissive-strength": {
@@ -8732,6 +8803,7 @@ var paint_symbol = {
 				"feature-state"
 			]
 		},
+		appearance: true,
 		"property-type": "data-driven"
 	},
 	"icon-color": {
@@ -8764,6 +8836,7 @@ var paint_symbol = {
 				"measure-light"
 			]
 		},
+		appearance: true,
 		"property-type": "data-driven"
 	},
 	"icon-halo-color": {
@@ -8796,6 +8869,7 @@ var paint_symbol = {
 				"measure-light"
 			]
 		},
+		appearance: true,
 		"property-type": "data-driven"
 	},
 	"icon-halo-width": {
@@ -8829,6 +8903,7 @@ var paint_symbol = {
 				"measure-light"
 			]
 		},
+		appearance: true,
 		"property-type": "data-driven"
 	},
 	"icon-halo-blur": {
@@ -8862,6 +8937,7 @@ var paint_symbol = {
 				"measure-light"
 			]
 		},
+		appearance: true,
 		"property-type": "data-driven"
 	},
 	"icon-translate": {
@@ -8873,6 +8949,7 @@ var paint_symbol = {
 			0
 		],
 		transition: true,
+		appearance: true,
 		units: "pixels",
 		doc: "Distance that the icon's anchor is moved from its original placement. Positive values indicate right and down, while negative values indicate left and up.",
 		requires: [
@@ -8980,6 +9057,7 @@ var paint_symbol = {
 				"measure-light"
 			]
 		},
+		appearance: true,
 		"property-type": "data-driven"
 	},
 	"text-occlusion-opacity": {
@@ -9013,6 +9091,7 @@ var paint_symbol = {
 				"measure-light"
 			]
 		},
+		appearance: true,
 		"property-type": "data-driven"
 	},
 	"text-color": {
@@ -9046,6 +9125,7 @@ var paint_symbol = {
 				"measure-light"
 			]
 		},
+		appearance: true,
 		"property-type": "data-driven"
 	},
 	"text-halo-color": {
@@ -9078,6 +9158,7 @@ var paint_symbol = {
 				"measure-light"
 			]
 		},
+		appearance: true,
 		"property-type": "data-driven"
 	},
 	"text-halo-width": {
@@ -9111,6 +9192,7 @@ var paint_symbol = {
 				"measure-light"
 			]
 		},
+		appearance: true,
 		"property-type": "data-driven"
 	},
 	"text-halo-blur": {
@@ -9144,6 +9226,7 @@ var paint_symbol = {
 				"measure-light"
 			]
 		},
+		appearance: true,
 		"property-type": "data-driven"
 	},
 	"text-translate": {
@@ -9155,6 +9238,7 @@ var paint_symbol = {
 			0
 		],
 		transition: true,
+		appearance: true,
 		units: "pixels",
 		doc: "Distance that the text's anchor is moved from its original placement. Positive values indicate right and down, while negative values indicate left and up.",
 		requires: [
@@ -9289,6 +9373,7 @@ var paint_symbol = {
 		minimum: 0,
 		transition: true,
 		experimental: true,
+		appearance: true,
 		"sdk-support": {
 			"basic functionality": {
 				js: "3.7.0",
@@ -10621,7 +10706,7 @@ var paint_model = {
 			1,
 			1
 		],
-		doc: "An array for configuring the fade-out effect for the front cutoff of content on pitched map views. It contains three values: start, range and final opacity. The start parameter defines the point at which the fade-out effect begins, with smaller values causing the effect to start earlier. The range parameter specifies how long the fade-out effect will last. A value of 0.0 for range makes content disappear immediately without a fade-out effect. The final opacity determines content opacity at the end of the fade-out effect. A value of 1.0 for final opacity means that the cutoff is completely disabled.",
+		doc: "An array for configuring the fade-out effect for the front cutoff of content on pitched map views. It contains three values: start, range and final opacity. The start parameter defines the point at which the fade-out effect begins, with smaller values causing the effect to start earlier. The range parameter specifies how long the fade-out effect will last. A value of 0.0 for range makes content disappear immediately without a fade-out effect. The final opacity determines content opacity at the end of the fade-out effect. A value of 1.0 for final opacity means that the cutoff is completely disabled. Note: The property has no effect on the map if terrain or globe projection is enabled.",
 		"sdk-support": {
 			"basic functionality": {
 				js: "3.5.0"
@@ -10655,6 +10740,24 @@ var paint_model = {
 				ios: "11.10.0"
 			}
 		}
+	},
+	"model-ignore-line-cutout": {
+		type: "boolean",
+		doc: "When set to true, the layer is not going to be affected by the line cutout effect.",
+		"default": false,
+		transition: false,
+		expression: {
+			interpolated: false
+		},
+		"property-type": "data-constant",
+		experimental: true,
+		"private": true,
+		"sdk-support": {
+			"basic functionality": {
+				android: "11.21.0",
+				ios: "11.21.0"
+			}
+		}
 	}
 };
 var transition = {
@@ -10869,6 +10972,22 @@ var v8 = {
 			interpolated: false
 		},
 		"property-type": "constant"
+	},
+	"source-max-zoom": {
+		type: "number",
+		minimum: 0,
+		maximum: 24,
+		"private": true,
+		experimental: true,
+		doc: "The maximum zoom level at which to load and parse source tiles for this layer. When set, tiles are never loaded or re-parsed above this zoom level. At higher zoom levels, the renderer reuses tiles from this zoom level without creating overscaled variants. This reduces the number of tiles parsed and prevents tile-border artifacts for layers like fill-extrusion.",
+		"sdk-support": {
+			"basic functionality": {
+				js: "3.21.0",
+				android: "11.21.0",
+				ios: "11.21.0"
+			}
+		},
+		"property-type": "constant"
 	}
 },
 	layout_building: layout_building,
@@ -11649,6 +11768,44 @@ var v8 = {
 		},
 		"property-type": "data-constant"
 	},
+	"fill-extrusion-front-cutoff": {
+		type: "array",
+		"private": true,
+		experimental: true,
+		value: "number",
+		"property-type": "data-constant",
+		transition: false,
+		expression: {
+			interpolated: true,
+			parameters: [
+				"zoom"
+			]
+		},
+		length: 3,
+		"default": [
+			0,
+			0,
+			1
+		],
+		minimum: [
+			0,
+			0,
+			0
+		],
+		maximum: [
+			1,
+			1,
+			1
+		],
+		doc: "An array for configuring the fade-out effect for the front cutoff of content on pitched map views. It contains three values: start, range and final opacity. The start parameter defines the point at which the fade-out effect begins, with smaller values causing the effect to start earlier. The range parameter specifies how long the fade-out effect will last. A value of 0.0 for range makes content disappear immediately without a fade-out effect. The final opacity determines content opacity at the end of the fade-out effect. A value of 1.0 for final opacity means that the cutoff is completely disabled. Note: The property has no effect on the map if terrain or globe projection is enabled.",
+		"sdk-support": {
+			"basic functionality": {
+				js: "3.21.0",
+				android: "11.21.0",
+				ios: "11.21.0"
+			}
+		}
+	},
 	"fill-extrusion-emissive-strength": {
 		type: "number",
 		"default": 0,
@@ -14722,8 +14879,7 @@ class CompoundExpression {
             let argParseFailed = false;
             for (let i = 1; i < args.length; i++) {
                 const arg = args[i];
-                const expectedType = Array.isArray(params) ? params[i - 1] : // @ts-expect-error - TS2339 - Property 'type' does not exist on type 'Varargs | Evaluate'.
-                params.type;
+                const expectedType = Array.isArray(params) ? params[i - 1] : params.type;
                 const parsed = signatureContext.parse(arg, 1 + parsedArgs.length, expectedType);
                 if (!parsed) {
                     argParseFailed = true;
@@ -14788,11 +14944,15 @@ class CollatorExpression {
         this.diacriticSensitive = diacriticSensitive;
     }
     static parse(args, context) {
-        if (args.length !== 2)
-            return context.error(`Expected one argument.`);
+        if (args.length !== 2) {
+            context.error(`Expected one argument.`);
+            return null;
+        }
         const options = args[1];
-        if (typeof options !== 'object' || Array.isArray(options))
-            return context.error(`Collator options argument must be an object.`);
+        if (typeof options !== 'object' || Array.isArray(options)) {
+            context.error(`Collator options argument must be an object.`);
+            return null;
+        }
         const caseSensitive = options['case-sensitive'] === void 0 ? context.parse(false, 1, BooleanType) : context.parseObjectValue(options['case-sensitive'], 1, 'case-sensitive', BooleanType);
         if (!caseSensitive)
             return null;
@@ -17473,7 +17633,8 @@ class Coalesce {
     }
     static parse(args, context) {
         if (args.length < 2) {
-            return context.error('Expectected at least one argument.');
+            context.error('Expectected at least one argument.');
+            return null;
         }
         let outputType = null;
         const expectedType = context.expectedType;
@@ -17690,7 +17851,8 @@ class In {
     }
     static parse(args, context) {
         if (args.length !== 3) {
-            return context.error(`Expected 2 arguments, but found ${ args.length - 1 } instead.`);
+            context.error(`Expected 2 arguments, but found ${ args.length - 1 } instead.`);
+            return null;
         }
         const needle = context.parse(args[1], 1, ValueType);
         const haystack = context.parse(args[2], 2, ValueType);
@@ -17703,7 +17865,8 @@ class In {
                 NullType,
                 ValueType
             ])) {
-            return context.error(`Expected first argument to be of type boolean, string, number or null, but found ${ toString$1(needle.type) } instead`);
+            context.error(`Expected first argument to be of type boolean, string, number or null, but found ${ toString$1(needle.type) } instead`);
+            return null;
         }
         return new In(needle, haystack);
     }
@@ -17753,7 +17916,8 @@ class IndexOf {
     }
     static parse(args, context) {
         if (args.length <= 2 || args.length >= 5) {
-            return context.error(`Expected 3 or 4 arguments, but found ${ args.length - 1 } instead.`);
+            context.error(`Expected 3 or 4 arguments, but found ${ args.length - 1 } instead.`);
+            return null;
         }
         const needle = context.parse(args[1], 1, ValueType);
         const haystack = context.parse(args[2], 2, ValueType);
@@ -17766,7 +17930,8 @@ class IndexOf {
                 NullType,
                 ValueType
             ])) {
-            return context.error(`Expected first argument to be of type boolean, string, number or null, but found ${ toString$1(needle.type) } instead`);
+            context.error(`Expected first argument to be of type boolean, string, number or null, but found ${ toString$1(needle.type) } instead`);
+            return null;
         }
         if (args.length === 4) {
             const fromIndex = context.parse(args[3], 3, NumberType);
@@ -17949,10 +18114,14 @@ class Case {
         this.otherwise = otherwise;
     }
     static parse(args, context) {
-        if (args.length < 4)
-            return context.error(`Expected at least 3 arguments, but found only ${ args.length - 1 }.`);
-        if (args.length % 2 !== 0)
-            return context.error(`Expected an odd number of arguments.`);
+        if (args.length < 4) {
+            context.error(`Expected at least 3 arguments, but found only ${ args.length - 1 }.`);
+            return null;
+        }
+        if (args.length % 2 !== 0) {
+            context.error(`Expected an odd number of arguments.`);
+            return null;
+        }
         let outputType;
         if (context.expectedType && context.expectedType.kind !== 'value') {
             outputType = context.expectedType;
@@ -18013,7 +18182,8 @@ class Slice {
     }
     static parse(args, context) {
         if (args.length <= 2 || args.length >= 5) {
-            return context.error(`Expected 3 or 4 arguments, but found ${ args.length - 1 } instead.`);
+            context.error(`Expected 3 or 4 arguments, but found ${ args.length - 1 } instead.`);
+            return null;
         }
         const input = context.parse(args[1], 1, ValueType);
         const beginIndex = context.parse(args[2], 2, NumberType);
@@ -18024,7 +18194,8 @@ class Slice {
                 StringType,
                 ValueType
             ])) {
-            return context.error(`Expected first argument to be of type array or string, but found ${ toString$1(input.type) } instead`);
+            context.error(`Expected first argument to be of type array or string, but found ${ toString$1(input.type) } instead`);
+            return null;
         }
         if (args.length === 4) {
             const endIndex = context.parse(args[3], 3, NumberType);
@@ -18368,13 +18539,17 @@ class Length {
         this.input = input;
     }
     static parse(args, context) {
-        if (args.length !== 2)
-            return context.error(`Expected 1 argument, but found ${ args.length - 1 } instead.`);
+        if (args.length !== 2) {
+            context.error(`Expected 1 argument, but found ${ args.length - 1 } instead.`);
+            return null;
+        }
         const input = context.parse(args[1], 1);
         if (!input)
             return null;
-        if (input.type.kind !== 'array' && input.type.kind !== 'string' && input.type.kind !== 'value')
-            return context.error(`Expected argument of type string or array, but found ${ toString$1(input.type) } instead.`);
+        if (input.type.kind !== 'array' && input.type.kind !== 'string' && input.type.kind !== 'value') {
+            context.error(`Expected argument of type string or array, but found ${ toString$1(input.type) } instead.`);
+            return null;
+        }
         return new Length(input);
     }
     evaluate(ctx) {
@@ -20193,9 +20368,7 @@ function convertFilter$1(filter) {
     op === '==' ? convertComparisonOp$1(filter[1], filter[2], '==') : // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
     op === '!=' ? convertNegation(convertComparisonOp$1(filter[1], filter[2], '==')) : op === '<' || op === '>' || op === '<=' || // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
     op === '>=' ? convertComparisonOp$1(filter[1], filter[2], op) : // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
-    op === 'any' ? convertDisjunctionOp(filter.slice(1)) : // @ts-expect-error - TS2769 - No overload matches this call.
-    op === 'all' ? ['all'].concat(filter.slice(1).map(convertFilter$1)) : // @ts-expect-error - TS2769 - No overload matches this call.
-    op === 'none' ? ['all'].concat(filter.slice(1).map(convertFilter$1).map(convertNegation)) : // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+    op === 'any' ? convertDisjunctionOp(filter.slice(1)) : op === 'all' ? ['all'].concat(filter.slice(1).map(convertFilter$1)) : op === 'none' ? ['all'].concat(filter.slice(1).map(convertFilter$1).map(convertNegation)) : // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
     op === 'in' ? convertInOp$1(filter[1], filter.slice(2)) : // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
     op === '!in' ? convertNegation(convertInOp$1(filter[1], filter.slice(2))) : // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
     op === 'has' ? convertHasOp$1(filter[1]) : // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
@@ -22254,6 +22427,7 @@ function validatePromoteId({key, value}) {
             expression.value.forEach(err => {
                 errors2.push(new ValidationError(`${ key }${ err.key }`, null, `${ err.message }`));
             });
+            return errors2;
         }
         const parsed = expression.value.expression;
         const onlyFeatureDependent = isGlobalPropertyConstant(parsed, [