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

package/dist/index.d.ts

@@ -489,6 +489,12 @@ type VectorSourceSpecification = {
 		number,
 		number
 	];
+	"extra_bounds"?: Array<[
+		number,
+		number,
+		number,
+		number
+	]>;
 	"scheme"?: "xyz" | "tms";
 	"minzoom"?: number;
 	"maxzoom"?: number;
@@ -507,6 +513,12 @@ type RasterSourceSpecification = {
 		number,
 		number
 	];
+	"extra_bounds"?: Array<[
+		number,
+		number,
+		number,
+		number
+	]>;
 	"minzoom"?: number;
 	"maxzoom"?: number;
 	"tileSize"?: number;
@@ -525,6 +537,12 @@ type RasterDEMSourceSpecification = {
 		number,
 		number
 	];
+	"extra_bounds"?: Array<[
+		number,
+		number,
+		number,
+		number
+	]>;
 	"minzoom"?: number;
 	"maxzoom"?: number;
 	"tileSize"?: number;
@@ -543,6 +561,12 @@ type RasterArraySourceSpecification = {
 		number,
 		number
 	];
+	"extra_bounds"?: Array<[
+		number,
+		number,
+		number,
+		number
+	]>;
 	"minzoom"?: number;
 	"maxzoom"?: number;
 	"tileSize"?: number;
@@ -721,6 +745,8 @@ type FillLayerSpecification = {
 		"fill-translate-transition"?: TransitionSpecification;
 		"fill-translate-anchor"?: PropertyValueSpecification<"map" | "viewport">;
 		"fill-pattern"?: DataDrivenPropertyValueSpecification<ResolvedImageSpecification>;
+		"fill-pattern-cross-fade"?: PropertyValueSpecification<number>;
+		"fill-pattern-cross-fade-transition"?: TransitionSpecification;
 		"fill-emissive-strength"?: PropertyValueSpecification<number>;
 		"fill-emissive-strength-transition"?: TransitionSpecification;
 		/**
@@ -798,6 +824,8 @@ type LineLayerSpecification = {
 		"line-blur-transition"?: TransitionSpecification;
 		"line-dasharray"?: DataDrivenPropertyValueSpecification<Array<number>>;
 		"line-pattern"?: DataDrivenPropertyValueSpecification<ResolvedImageSpecification>;
+		"line-pattern-cross-fade"?: PropertyValueSpecification<number>;
+		"line-pattern-cross-fade-transition"?: TransitionSpecification;
 		"line-gradient"?: ExpressionSpecification;
 		"line-gradient-use-theme"?: PropertyValueSpecification<string>;
 		"line-trim-offset"?: [
@@ -931,7 +959,7 @@ type SymbolLayerSpecification = {
 		]>;
 		"icon-translate-transition"?: TransitionSpecification;
 		"icon-translate-anchor"?: PropertyValueSpecification<"map" | "viewport">;
-		"icon-image-cross-fade"?: DataDrivenPropertyValueSpecification<number>;
+		"icon-image-cross-fade"?: PropertyValueSpecification<number>;
 		"icon-image-cross-fade-transition"?: TransitionSpecification;
 		"text-opacity"?: DataDrivenPropertyValueSpecification<number>;
 		"text-opacity-transition"?: TransitionSpecification;
@@ -1066,6 +1094,8 @@ type FillExtrusionLayerSpecification = {
 		"fill-extrusion-translate-transition"?: TransitionSpecification;
 		"fill-extrusion-translate-anchor"?: PropertyValueSpecification<"map" | "viewport">;
 		"fill-extrusion-pattern"?: DataDrivenPropertyValueSpecification<ResolvedImageSpecification>;
+		"fill-extrusion-pattern-cross-fade"?: PropertyValueSpecification<number>;
+		"fill-extrusion-pattern-cross-fade-transition"?: TransitionSpecification;
 		"fill-extrusion-height"?: DataDrivenPropertyValueSpecification<number>;
 		"fill-extrusion-height-transition"?: TransitionSpecification;
 		"fill-extrusion-base"?: DataDrivenPropertyValueSpecification<number>;
@@ -1505,7 +1535,7 @@ type LayerSpecification = FillLayerSpecification | LineLayerSpecification | Symb
 export function derefLayers(layers: Array<LayerSpecification>): Array<LayerSpecification>;
 type Command = {
 	command: string;
-	args: Array<any>;
+	args: unknown[];
 };
 /**
  * Diff two stylesheet
@@ -1530,8 +1560,8 @@ export declare class ValidationError {
 	message: string;
 	identifier: string | null | undefined;
 	line: number | null | undefined;
-	constructor(key: string | null | undefined, value: {
-		__line__: number;
+	constructor(key: string | null | undefined, value: (string | number | boolean) & {
+		__line__?: number;
 	} | null | undefined, message: string, identifier?: string | null);
 }
 export declare class ParsingError {
@@ -1706,7 +1736,7 @@ declare class ImageVariant {
 	constructor(id: string | ImageIdSpec, options?: RasterizationOptions);
 	toString(): StringifiedImageVariant;
 	static parse(str: StringifiedImageVariant): ImageVariant | null;
-	scaleSelf(factor: number): this;
+	scaleSelf(factor: number, yFactor?: number): this;
 }
 declare class ResolvedImage {
 	primaryId: ImageId;
@@ -1893,7 +1923,7 @@ interface Feature {
 	readonly type: 0 | 1 | 2 | 3 | "Unknown" | "Point" | "LineString" | "Polygon";
 	readonly id?: string | number | null;
 	readonly properties: Record<PropertyKey, unknown>;
-	readonly patterns?: Record<PropertyKey, string>;
+	readonly patterns?: Record<PropertyKey, string[]>;
 	readonly geometry?: Array<Array<Point>>;
 }
 type FeatureState = {
@@ -2081,6 +2111,10 @@ type ValidationErrors = ReadonlyArray<ValidationError$1>;
  *   var errors = validate(style);
  */
 declare function validateStyle(style: StyleSpecification | string | Buffer, styleSpec?: StyleReference): ValidationErrors;
+type MapboxStyleSpecification = StyleSpecification & {
+	visibility?: "public" | "private";
+	protected?: boolean;
+};
 /**
  * Validate a Mapbox GL style against the style specification and check for
  * compatibility with the Mapbox Styles API.
@@ -2091,7 +2125,7 @@ declare function validateStyle(style: StyleSpecification | string | Buffer, styl
  *   var validateMapboxApiSupported = require('mapbox-gl-style-spec/lib/validate_style_mapbox_api_supported.js');
  *   var errors = validateMapboxApiSupported(style);
  */
-export function validateMapboxApiSupported(style: any, styleSpec?: any): ValidationErrors;
+export function validateMapboxApiSupported(style: MapboxStyleSpecification, styleSpec?: StyleReference): ValidationErrors;
 type ExpressionType = "data-driven" | "color-ramp" | "data-constant" | "constant";
 type ExpressionParameters = Array<"zoom" | "feature" | "feature-state" | "heatmap-density" | "line-progress" | "raster-value" | "sky-radial-progress" | "pitch" | "distance-from-center" | "measure-light" | "raster-particle-speed">;
 type ExpressionSpecification$1 = {

package/dist/index.es.js

@@ -788,6 +788,16 @@ var source_vector = {
 		],
 		doc: "An array containing the longitude and latitude of the southwest and northeast corners of the source's bounding box in the following order: `[sw.lng, sw.lat, ne.lng, ne.lat]`. When this property is included in a source, no tiles outside of the given bounds are requested by Mapbox GL."
 	},
+	extra_bounds: {
+		type: "array",
+		value: {
+			type: "array",
+			value: "number",
+			length: 4,
+			doc: "An array containing the longitude and latitude of the southwest and northeast corners of the source's bounding box in the following order: `[sw.lng, sw.lat, ne.lng, ne.lat]`."
+		},
+		doc: "An array of additional discrete geographic regions where tiles are available. When used alongside the `bounds` property, these regions act as an additional filter - Mapbox GL will only request tiles that are both within the `bounds` and any of the regions defined in `extra_bounds`. When used independently (without `bounds`), Mapbox GL will request tiles that fall within any of the regions in `extra_bounds`. This allows for more fine-grained control over tile requests, particularly when dealing with sparse data coverage."
+	},
 	scheme: {
 		type: "enum",
 		values: {
@@ -867,6 +877,16 @@ var source_raster = {
 		],
 		doc: "An array containing the longitude and latitude of the southwest and northeast corners of the source's bounding box in the following order: `[sw.lng, sw.lat, ne.lng, ne.lat]`. When this property is included in a source, no tiles outside of the given bounds are requested by Mapbox GL."
 	},
+	extra_bounds: {
+		type: "array",
+		value: {
+			type: "array",
+			value: "number",
+			length: 4,
+			doc: "An array containing the longitude and latitude of the southwest and northeast corners of the source's bounding box in the following order: `[sw.lng, sw.lat, ne.lng, ne.lat]`."
+		},
+		doc: "An array of additional discrete geographic regions where tiles are available. When used alongside the `bounds` property, these regions act as an additional filter - Mapbox GL will only request tiles that are both within the `bounds` and any of the regions defined in `extra_bounds`. When used independently (without `bounds`), Mapbox GL will request tiles that fall within any of the regions in `extra_bounds`. This allows for more fine-grained control over tile requests, particularly when dealing with sparse data coverage."
+	},
 	minzoom: {
 		type: "number",
 		"default": 0,
@@ -948,6 +968,16 @@ var source_raster_dem = {
 		],
 		doc: "An array containing the longitude and latitude of the southwest and northeast corners of the source's bounding box in the following order: `[sw.lng, sw.lat, ne.lng, ne.lat]`. When this property is included in a source, no tiles outside of the given bounds are requested by Mapbox GL."
 	},
+	extra_bounds: {
+		type: "array",
+		value: {
+			type: "array",
+			value: "number",
+			length: 4,
+			doc: "An array containing the longitude and latitude of the southwest and northeast corners of the source's bounding box in the following order: `[sw.lng, sw.lat, ne.lng, ne.lat]`."
+		},
+		doc: "An array of additional discrete geographic regions where tiles are available. When used alongside the `bounds` property, these regions act as an additional filter - Mapbox GL will only request tiles that are both within the `bounds` and any of the regions defined in `extra_bounds`. When used independently (without `bounds`), Mapbox GL will request tiles that fall within any of the regions in `extra_bounds`. This allows for more fine-grained control over tile requests, particularly when dealing with sparse data coverage."
+	},
 	minzoom: {
 		type: "number",
 		"default": 0,
@@ -1030,6 +1060,16 @@ var source_raster_array = {
 		],
 		doc: "An array containing the longitude and latitude of the southwest and northeast corners of the source's bounding box in the following order: `[sw.lng, sw.lat, ne.lng, ne.lat]`. When this property is included in a source, no tiles outside of the given bounds are requested by Mapbox GL."
 	},
+	extra_bounds: {
+		type: "array",
+		value: {
+			type: "array",
+			value: "number",
+			length: 4,
+			doc: "An array containing the longitude and latitude of the southwest and northeast corners of the source's bounding box in the following order: `[sw.lng, sw.lat, ne.lng, ne.lat]`."
+		},
+		doc: "An array of additional discrete geographic regions where tiles are available. When used alongside the `bounds` property, these regions act as an additional filter - Mapbox GL will only request tiles that are both within the `bounds` and any of the regions defined in `extra_bounds`. When used independently (without `bounds`), Mapbox GL will request tiles that fall within any of the regions in `extra_bounds`. This allows for more fine-grained control over tile requests, particularly when dealing with sparse data coverage."
+	},
 	minzoom: {
 		type: "number",
 		"default": 0,
@@ -6444,6 +6484,30 @@ var paint_fill = {
 		},
 		"property-type": "data-driven"
 	},
+	"fill-pattern-cross-fade": {
+		type: "number",
+		"property-type": "data-constant",
+		"default": 0,
+		minimum: 0,
+		maximum: 1,
+		expression: {
+			interpolated: true,
+			parameters: [
+				"zoom",
+				"measure-light"
+			]
+		},
+		requires: [
+			"line-pattern"
+		],
+		"sdk-support": {
+			"basic functionality": {
+				js: "3.12.0"
+			}
+		},
+		doc: "Controls the transition progress between the image variants of fill-pattern. Zero means the first variant is used, one is the second, and in between they are blended together.",
+		transition: true
+	},
 	"fill-emissive-strength": {
 		type: "number",
 		"default": 0,
@@ -7028,6 +7092,30 @@ var paint_line = {
 		},
 		"property-type": "data-driven"
 	},
+	"line-pattern-cross-fade": {
+		type: "number",
+		"property-type": "data-constant",
+		"default": 0,
+		minimum: 0,
+		maximum: 1,
+		expression: {
+			interpolated: true,
+			parameters: [
+				"zoom",
+				"measure-light"
+			]
+		},
+		requires: [
+			"line-pattern"
+		],
+		"sdk-support": {
+			"basic functionality": {
+				js: "3.12.0"
+			}
+		},
+		doc: "Controls the transition progress between the image variants of line-pattern. Zero means the first variant is used, one is the second, and in between they are blended together.",
+		transition: true
+	},
 	"line-gradient": {
 		type: "color",
 		doc: "A gradient used to color a line feature at various distances along its length. Defined using a `step` or `interpolate` expression which outputs a color for each corresponding `line-progress` input value. `line-progress` is a percentage of the line feature's total length as measured on the webmercator projected coordinate plane (a `number` between `0` and `1`). Can only be used with GeoJSON sources that specify `\"lineMetrics\": true`.",
@@ -8106,7 +8194,7 @@ var paint_symbol = {
 	},
 	"icon-image-cross-fade": {
 		type: "number",
-		"property-type": "data-driven",
+		"property-type": "data-constant",
 		"default": 0,
 		minimum: 0,
 		maximum: 1,
@@ -8114,8 +8202,6 @@ var paint_symbol = {
 			interpolated: true,
 			parameters: [
 				"zoom",
-				"feature",
-				"feature-state",
 				"measure-light"
 			]
 		},
@@ -8127,11 +8213,6 @@ var paint_symbol = {
 				js: "3.0.0",
 				android: "11.0.0",
 				ios: "11.0.0"
-			},
-			"data-driven styling": {
-				js: "3.0.0",
-				android: "11.0.0",
-				ios: "11.0.0"
 			}
 		},
 		doc: "Controls the transition progress between the image variants of icon-image. Zero means the first variant is used, one is the second, and in between they are blended together.",
@@ -10252,6 +10333,30 @@ var v8 = {
 		},
 		"property-type": "data-driven"
 	},
+	"fill-extrusion-pattern-cross-fade": {
+		type: "number",
+		"property-type": "data-constant",
+		"default": 0,
+		minimum: 0,
+		maximum: 1,
+		expression: {
+			interpolated: true,
+			parameters: [
+				"zoom",
+				"measure-light"
+			]
+		},
+		requires: [
+			"line-pattern"
+		],
+		"sdk-support": {
+			"basic functionality": {
+				js: "3.12.0"
+			}
+		},
+		doc: "Controls the transition progress between the image variants of fill-extrusion-pattern. Zero means the first variant is used, one is the second, and in between they are blended together.",
+		transition: true
+	},
 	"fill-extrusion-height": {
 		type: "number",
 		"default": 0,
@@ -12919,8 +13024,8 @@ class ImageVariant {
             ])
         });
     }
-    scaleSelf(factor) {
-        this.options.transform.scaleSelf(factor);
+    scaleSelf(factor, yFactor) {
+        this.options.transform.scaleSelf(factor, yFactor);
         return this;
     }
 }
@@ -13215,6 +13320,7 @@ class Assertion {
         }
         return new Assertion(type, parsed);
     }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     evaluate(ctx) {
         for (let i = 0; i < this.args.length; i++) {
             const value = this.args[i].evaluate(ctx);
@@ -13634,6 +13740,7 @@ class Coercion {
         }
         return new Coercion(type, parsed);
     }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     evaluate(ctx) {
         if (this.type.kind === 'boolean') {
             return Boolean(this.args[0].evaluate(ctx));
@@ -15770,6 +15877,7 @@ class Config {
         }
         return new Config(type, toString(configKey.value));
     }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     evaluate(ctx) {
         const FQIDSeparator = '\x1F';
         const configKey = [
@@ -15914,6 +16022,7 @@ class Var {
         }
         return new Var(name, context.scope.get(name));
     }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     evaluate(ctx) {
         return this.boundExpression.evaluate(ctx);
     }
@@ -16179,6 +16288,7 @@ class Step {
         }
         return new Step(outputType, input, stops);
     }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     evaluate(ctx) {
         const labels = this.labels;
         const outputs = this.outputs;
@@ -16581,6 +16691,7 @@ class Coalesce {
         const needsAnnotation = expectedType && parsedArgs.some(arg => checkSubtype(expectedType, arg.type));
         return needsAnnotation ? new Coalesce(ValueType, parsedArgs) : new Coalesce(outputType, parsedArgs);
     }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     evaluate(ctx) {
         let result = null;
         let argCount = 0;
@@ -16623,6 +16734,7 @@ class Let {
         this.bindings = [].concat(bindings);
         this.result = result;
     }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     evaluate(ctx) {
         return this.result.evaluate(ctx);
     }
@@ -16865,6 +16977,7 @@ class IndexOf {
             return new IndexOf(needle, haystack);
         }
     }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     evaluate(ctx) {
         const needle = this.needle.evaluate(ctx);
         const haystack = this.haystack.evaluate(ctx);
@@ -16981,6 +17094,7 @@ class Match {
         }
         return new Match(inputType, outputType, input, cases, outputs, otherwise);
     }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     evaluate(ctx) {
         const input = this.input.evaluate(ctx);
         const output = typeOf(input) === this.inputType && this.outputs[this.cases[input]] || this.otherwise;
@@ -17062,6 +17176,7 @@ class Case {
             return null;
         return new Case(outputType, branches, otherwise);
     }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     evaluate(ctx) {
         for (const [test, expression] of this.branches) {
             if (test.evaluate(ctx)) {
@@ -17120,6 +17235,7 @@ class Slice {
             return new Slice(input.type, input, beginIndex);
         }
     }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     evaluate(ctx) {
         const input = this.input.evaluate(ctx);
         const beginIndex = this.beginIndex.evaluate(ctx);
@@ -17640,6 +17756,7 @@ CompoundExpression.register(expressions, {
         overloads: [
             [
                 [StringType],
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-return
                 (ctx, [key]) => get(key.evaluate(ctx), ctx.properties())
             ],
             [
@@ -17647,6 +17764,7 @@ CompoundExpression.register(expressions, {
                     StringType,
                     ObjectType
                 ],
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-return
                 (ctx, [key, obj]) => get(key.evaluate(ctx), obj.evaluate(ctx))
             ]
         ]
@@ -17654,6 +17772,7 @@ CompoundExpression.register(expressions, {
     'feature-state': [
         ValueType,
         [StringType],
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
         (ctx, [key]) => get(key.evaluate(ctx), ctx.featureState || {})
     ],
     'properties': [
@@ -17851,11 +17970,13 @@ CompoundExpression.register(expressions, {
     'min': [
         NumberType,
         varargs(NumberType),
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
         (ctx, args) => Math.min(...args.map(arg => arg.evaluate(ctx)))
     ],
     'max': [
         NumberType,
         varargs(NumberType),
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
         (ctx, args) => Math.max(...args.map(arg => arg.evaluate(ctx)))
     ],
     'abs': [
@@ -18029,6 +18150,7 @@ CompoundExpression.register(expressions, {
                     BooleanType,
                     BooleanType
                 ],
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-return
                 (ctx, [a, b]) => a.evaluate(ctx) && b.evaluate(ctx)
             ],
             [
@@ -18051,6 +18173,7 @@ CompoundExpression.register(expressions, {
                     BooleanType,
                     BooleanType
                 ],
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-return
                 (ctx, [a, b]) => a.evaluate(ctx) || b.evaluate(ctx)
             ],
             [
@@ -18085,11 +18208,13 @@ CompoundExpression.register(expressions, {
     'upcase': [
         StringType,
         [StringType],
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
         (ctx, [s]) => s.evaluate(ctx).toUpperCase()
     ],
     'downcase': [
         StringType,
         [StringType],
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
         (ctx, [s]) => s.evaluate(ctx).toLowerCase()
     ],
     'concat': [
@@ -18100,6 +18225,7 @@ CompoundExpression.register(expressions, {
     'resolved-locale': [
         StringType,
         [CollatorType],
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
         (ctx, [collator]) => collator.evaluate(ctx).resolvedLocale()
     ],
     'random': [
@@ -18247,6 +18373,7 @@ function createFunction(parameters, propertySpec) {
             kind: 'composite',
             interpolationType,
             interpolationFactor: Interpolate.interpolationFactor.bind(void 0, interpolationType),
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-return
             zoomStops: featureFunctionStops.map(s => s[0]),
             evaluate({zoom}, properties) {
                 return evaluateExponentialFunction({
@@ -18264,7 +18391,9 @@ function createFunction(parameters, propertySpec) {
             kind: 'camera',
             interpolationType,
             interpolationFactor: Interpolate.interpolationFactor.bind(void 0, interpolationType),
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-return
             zoomStops: parameters.stops.map(s => s[0]),
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-return
             evaluate: ({zoom}) => innerFun(parameters, propertySpec, zoom, hashedStops, categoricalKeyType)
         };
     } else {
@@ -19370,7 +19499,8 @@ function convertInOp(property, values, negate = false) {
             negate
         ];
     }
-    return [negate ? 'all' : 'any'].concat(values.map(v => [
+    return [negate ? 'all' : 'any'].concat(// eslint-disable-next-line @typescript-eslint/no-explicit-any
+    values.map(v => [
         negate ? '!=' : '==',
         get,
         v
@@ -22626,7 +22756,7 @@ function isValid(value, regex) {
     return !!value.match(regex);
 }
 function getSourceCount(source) {
-    if (source.url) {
+    if ('url' in source) {
         return source.url.split(',').length;
     } else {
         return 0;
@@ -22665,7 +22795,7 @@ function getSourceErrors(source, i) {
         errors.push(new ValidationError(`sources[${ i }].type`, source.type, `Expected one of [${ Array.from(acceptedSourceTypes).join(', ') }]`));
     }
     const sourceUrlPattern = /^mapbox:\/\/([^/]*)$/;
-    if (!source.url || !isValid(source.url, sourceUrlPattern)) {
+    if (!('url' in source) || !isValid(source.url, sourceUrlPattern)) {
         errors.push(new ValidationError(`sources[${ i }].url`, source.url, 'Expected a valid Mapbox tileset url'));
     }
     return errors;