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

package/dist/index.cjs

@@ -204,7 +204,7 @@
   	},
   	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: [
@@ -2400,7 +2400,6 @@
   		minimum: 0,
   		units: "meters",
   		doc: "The height of the procedural buildings.",
-  		transition: true,
   		"private": true,
   		"sdk-support": {
   			"basic functionality": {
@@ -2425,7 +2424,6 @@
   		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"
   		],
@@ -2458,7 +2456,6 @@
   		requires: [
   			"lights"
   		],
-  		transition: true,
   		expression: {
   			interpolated: true,
   			parameters: [
@@ -2489,7 +2486,6 @@
   		requires: [
   			"lights"
   		],
-  		transition: true,
   		expression: {
   			interpolated: true,
   			parameters: [
@@ -2516,7 +2512,6 @@
   		"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"
   		],
@@ -2860,7 +2855,6 @@
   		requires: [
   			"line-z-offset"
   		],
-  		transition: true,
   		"property-type": "data-driven"
   	}
   };
@@ -10009,6 +10003,64 @@
   			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 = {
@@ -15169,7 +15221,7 @@
     serialize() {
       const res = ["config", this.key];
       if (this.scope) {
-        res.concat(this.scope);
+        res.push(this.scope);
       }
       return res;
     }
@@ -17996,12 +18048,13 @@
       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;
   }
@@ -18226,6 +18279,7 @@
       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;
@@ -20443,6 +20497,25 @@ Use an identity property function instead: ${example}.`
         }
       }
     }
+    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,