@mapbox/mapbox-gl-style-spec 14.33.0 → 14.34.1-alpha.1

package/dist/index.d.ts

@@ -2354,7 +2354,6 @@ declare const _exports: {
             minimum: number;
             units: string;
             doc: string;
-            transition: boolean;
             private: boolean;
             "sdk-support": {
                 "basic functionality": {
@@ -2379,7 +2378,6 @@ declare const _exports: {
             minimum: number;
             units: string;
             doc: string;
-            transition: boolean;
             requires: string[];
             private: boolean;
             "sdk-support": {
@@ -2408,7 +2406,6 @@ declare const _exports: {
             minimum: number;
             doc: string;
             requires: string[];
-            transition: boolean;
             expression: {
                 interpolated: boolean;
                 parameters: string[];
@@ -2434,7 +2431,6 @@ declare const _exports: {
             default: number;
             doc: string;
             requires: string[];
-            transition: boolean;
             expression: {
                 interpolated: boolean;
                 parameters: string[];
@@ -2458,7 +2454,6 @@ declare const _exports: {
             private: boolean;
             default: boolean;
             doc: string;
-            transition: boolean;
             requires: string[];
             expression: {
                 interpolated: boolean;
@@ -2764,7 +2759,6 @@ declare const _exports: {
                 parameters: string[];
             };
             requires: string[];
-            transition: boolean;
             "property-type": string;
         };
     };
@@ -9550,6 +9544,60 @@ declare const _exports: {
             };
             "property-type": string;
         };
+        "raster-mask": {
+            type: string;
+            required: boolean;
+            experimental: boolean;
+            private: boolean;
+            doc: string;
+            example: string;
+            transition: boolean;
+            "sdk-support": {
+                "basic functionality": {
+                    js: string;
+                };
+            };
+            "property-type": string;
+        };
+        "raster-mask-import": {
+            type: string;
+            required: boolean;
+            experimental: boolean;
+            private: boolean;
+            doc: string;
+            example: string;
+            transition: boolean;
+            requires: string[];
+            "sdk-support": {
+                "basic functionality": {
+                    js: string;
+                };
+            };
+            "property-type": string;
+        };
+        "raster-mask-mode": {
+            type: string;
+            doc: string;
+            values: {
+                "clip-path-intersect": {
+                    doc: string;
+                };
+                "clip-path-exclude": {
+                    doc: string;
+                };
+            };
+            default: string;
+            experimental: boolean;
+            private: boolean;
+            transition: boolean;
+            requires: string[];
+            "sdk-support": {
+                "basic functionality": {
+                    js: string;
+                };
+            };
+            "property-type": string;
+        };
     };
     "paint_raster-particle": {
         "raster-particle-array-band": {
@@ -11303,7 +11351,6 @@ type LineLayerSpecification = {
          */
         "line-width-unit"?: PropertyValueSpecification<"pixels" | "meters">;
         "line-elevation-ground-scale"?: DataDrivenPropertyValueSpecification<number>;
-        "line-elevation-ground-scale-transition"?: TransitionSpecification;
     };
     "paint"?: {
         "line-opacity"?: DataDrivenPropertyValueSpecification<number>;
@@ -11737,15 +11784,10 @@ type BuildingLayerSpecification = {
         "building-facade-window"?: DataDrivenPropertyValueSpecification<[number, number]>;
         "building-roof-shape"?: DataDrivenPropertyValueSpecification<"flat" | "hipped" | "gabled" | "parapet" | "mansard" | "skillion" | "pyramidal">;
         "building-height"?: DataDrivenPropertyValueSpecification<number>;
-        "building-height-transition"?: TransitionSpecification;
         "building-base"?: DataDrivenPropertyValueSpecification<number>;
-        "building-base-transition"?: TransitionSpecification;
         "building-flood-light-wall-radius"?: DataDrivenPropertyValueSpecification<number>;
-        "building-flood-light-wall-radius-transition"?: TransitionSpecification;
         "building-flood-light-ground-radius"?: DataDrivenPropertyValueSpecification<number>;
-        "building-flood-light-ground-radius-transition"?: TransitionSpecification;
         "building-flip-roof-orientation"?: DataDrivenPropertyValueSpecification<boolean>;
-        "building-flip-roof-orientation-transition"?: TransitionSpecification;
     };
     "paint"?: {
         "building-opacity"?: PropertyValueSpecification<number>;
@@ -11841,6 +11883,18 @@ type RasterLayerSpecification = {
          * @experimental This property is experimental and subject to change in future versions.
          */
         "raster-elevation-reference"?: "sea" | "ground" | ExpressionSpecification;
+        /**
+         * @experimental This property is experimental and subject to change in future versions.
+         */
+        "raster-mask"?: string;
+        /**
+         * @experimental This property is experimental and subject to change in future versions.
+         */
+        "raster-mask-import"?: string;
+        /**
+         * @experimental This property is experimental and subject to change in future versions.
+         */
+        "raster-mask-mode"?: "clip-path-intersect" | "clip-path-exclude";
     };
     "appearances"?: Array<AppearanceSpecification>;
 };
@@ -12697,6 +12751,7 @@ declare class StyleExpression {
     } | null;
     configDependencies: Set<string>;
     isIndoorDependent: boolean;
+    isImageDependent: boolean;
     constructor(expression: Expression, propertySpec?: StylePropertySpecification | null, scope?: string | null, options?: ConfigOptions | null, iconImageUseTheme?: string | null);
     evaluateWithoutErrorHandling(globals: GlobalProperties, feature?: Feature, featureState?: FeatureState, canonical?: CanonicalTileID, availableImages?: ImageId[], formattedSection?: FormattedSection, featureTileCoord?: Point, featureDistanceData?: FeatureDistanceData): any;
     evaluate(globals: GlobalProperties, feature?: Feature, featureState?: FeatureState, canonical?: CanonicalTileID, availableImages?: ImageId[], formattedSection?: FormattedSection, featureTileCoord?: Point, featureDistanceData?: FeatureDistanceData, iconImageUseTheme?: string): any;

package/dist/index.es.js

@@ -198,7 +198,7 @@ var $root = {
 	},
 	projection: {
 		type: "projection",
-		doc: "The projection the map should be rendered in. Supported projections are Mercator, Globe, Albers, Equal Earth, Equirectangular (WGS84), Lambert conformal conic, Natural Earth, and Winkel Tripel. Terrain, sky and fog are supported by only Mercator and globe. CustomLayerInterface is not supported outside of Mercator.",
+		doc: "The projection the map should be rendered in. Supported projections are Mercator, Globe, Albers, Equal Earth, Equirectangular (WGS84), Lambert conformal conic, Natural Earth, and Winkel Tripel. Terrain, sky and fog are supported by only Mercator and globe. CustomLayerInterface is supported by only Mercator and globe.",
 		example: {
 			name: "albers",
 			center: [
@@ -2394,7 +2394,6 @@ var layout_building = {
 		minimum: 0,
 		units: "meters",
 		doc: "The height of the procedural buildings.",
-		transition: true,
 		"private": true,
 		"sdk-support": {
 			"basic functionality": {
@@ -2419,7 +2418,6 @@ var layout_building = {
 		minimum: 0,
 		units: "meters",
 		doc: "The height with which to extrude the base of this layer. Must be less than or equal to `building-height`.",
-		transition: true,
 		requires: [
 			"building-height"
 		],
@@ -2452,7 +2450,6 @@ var layout_building = {
 		requires: [
 			"lights"
 		],
-		transition: true,
 		expression: {
 			interpolated: true,
 			parameters: [
@@ -2483,7 +2480,6 @@ var layout_building = {
 		requires: [
 			"lights"
 		],
-		transition: true,
 		expression: {
 			interpolated: true,
 			parameters: [
@@ -2510,7 +2506,6 @@ var layout_building = {
 		"private": true,
 		"default": false,
 		doc: "Flips the orientation of the roofs for the buildings. This only affects simple geometries. Namely buildings whose footprints form a quadrilateral. By default (false), the roof ridge takes the direction of the longer edge of the quadrilateral.",
-		transition: true,
 		requires: [
 			"building-roof-shape"
 		],
@@ -2854,7 +2849,6 @@ var layout_line = {
 		requires: [
 			"line-z-offset"
 		],
-		transition: true,
 		"property-type": "data-driven"
 	}
 };
@@ -10003,6 +9997,64 @@ var paint_raster = {
 			interpolated: false
 		},
 		"property-type": "data-constant"
+	},
+	"raster-mask": {
+		type: "string",
+		required: false,
+		experimental: true,
+		"private": true,
+		doc: "The id of a `fill` layer in the same style whose polygons should clip this layer. Only the geometry is used: set `fill-opacity` to 0 to keep the layer invisible, but don't hide it with `visibility`, `minzoom` or `maxzoom`. To use a featureset from another import, see `raster-mask-import`. Elevated `fill` layers and `raster-elevation` are not supported. This layer is only drawn where the mask's data has loaded, and not at all if the mask can't be used.",
+		example: "water",
+		transition: false,
+		"sdk-support": {
+			"basic functionality": {
+				js: "3.34.0"
+			}
+		},
+		"property-type": "data-constant"
+	},
+	"raster-mask-import": {
+		type: "string",
+		required: false,
+		experimental: true,
+		"private": true,
+		doc: "The id of an import of this style. When set, `raster-mask` is the id of a featureset of that import instead of a layer id, and the mask is made of the `fill` layers the featureset selects. If the featureset can't be found, or selects no `fill` layers, this layer is not drawn.",
+		example: "basemap",
+		transition: false,
+		requires: [
+			"raster-mask"
+		],
+		"sdk-support": {
+			"basic functionality": {
+				js: "3.34.0"
+			}
+		},
+		"property-type": "data-constant"
+	},
+	"raster-mask-mode": {
+		type: "enum",
+		doc: "Whether this layer is drawn inside or outside the mask.",
+		values: {
+			"clip-path-intersect": {
+				doc: "Draw only where the mask layer's geometry covers the map."
+			},
+			"clip-path-exclude": {
+				doc: "Draw only where the mask layer's geometry does not cover the map."
+			}
+		},
+		"default": "clip-path-intersect",
+		experimental: true,
+		"private": true,
+		transition: false,
+		requires: [
+			"raster-mask"
+		],
+		"sdk-support": {
+			"basic functionality": {
+				js: "3.34.0"
+			}
+		},
+		"property-type": "data-constant"
 	}
 };
 var paint_hillshade = {
@@ -15163,7 +15215,7 @@ class Config {
   serialize() {
     const res = ["config", this.key];
     if (this.scope) {
-      res.concat(this.scope);
+      res.push(this.scope);
     }
     return res;
   }
@@ -17990,12 +18042,13 @@ function collect(e, deps) {
     return;
   }
   if (e instanceof CompoundExpression && e.name === "is-active-floor") deps.isIndoorDependent = true;
+  if (e instanceof ImageExpression) deps.isImageDependent = true;
   e.eachChild((arg) => {
     collect(arg, deps);
   });
 }
 function getExpressionDependencies(e) {
-  const deps = { configDependencies: NO_CONFIG_DEPENDENCIES, isIndoorDependent: false };
+  const deps = { configDependencies: NO_CONFIG_DEPENDENCIES, isIndoorDependent: false, isImageDependent: false };
   collect(e, deps);
   return deps;
 }
@@ -18220,6 +18273,7 @@ class StyleExpression {
     const dependencies = getExpressionDependencies(expression);
     this.configDependencies = dependencies.configDependencies;
     this.isIndoorDependent = dependencies.isIndoorDependent;
+    this.isImageDependent = dependencies.isImageDependent;
   }
   evaluateWithoutErrorHandling(globals, feature, featureState, canonical, availableImages, formattedSection, featureTileCoord, featureDistanceData) {
     const evaluator = this._evaluator;
@@ -20437,6 +20491,25 @@ function validateLayer(options) {
       }
     }
   }
+  if (type === "raster" && isObject(layer.paint)) {
+    const paint = layer.paint;
+    const maskId = unbundle(paint["raster-mask"]);
+    const importId = unbundle(paint["raster-mask-import"]);
+    if (isString(maskId) && maskId) {
+      if (isString(importId) && importId) {
+        if (!(style.imports || []).some((i) => unbundle(i.id) === importId)) {
+          errors.push(new ValidationError(`${key}.paint.raster-mask-import`, paint["raster-mask-import"], `import "${importId}" not found`));
+        }
+      } else {
+        const maskLayer = (style.layers || []).find((l) => unbundle(l.id) === maskId);
+        if (!maskLayer) {
+          errors.push(new ValidationError(`${key}.paint.raster-mask`, paint["raster-mask"], `layer "${maskId}" not found`));
+        } else if (unbundle(maskLayer.type) !== "fill") {
+          errors.push(new ValidationError(`${key}.paint.raster-mask`, paint["raster-mask"], `layer "${maskId}" must be a "fill" layer`));
+        }
+      }
+    }
+  }
   errors = errors.concat(validateObject({
     key,
     value: layer,