@mapbox/mapbox-gl-style-spec 14.30.0 → 14.31.0

package/dist/index.d.ts

@@ -1574,6 +1574,14 @@ declare const _exports: {
                         };
                     };
                 };
+                "placement-group": {
+                    doc: string;
+                    "sdk-support": {
+                        "basic functionality": {};
+                    };
+                    private: boolean;
+                    experimental: boolean;
+                };
                 clip: {
                     doc: string;
                     "sdk-support": {
@@ -9136,6 +9144,42 @@ declare const _exports: {
             };
             "property-type": string;
         };
+        "placement-priority": {
+            type: string;
+            doc: string;
+            default: number;
+            minimum: number;
+            transition: boolean;
+            appearance: boolean;
+            expression: {
+                interpolated: boolean;
+                parameters: string[];
+            };
+            "property-type": string;
+            "sdk-support": {
+                "basic functionality": {};
+                "data-driven styling": {};
+            };
+            private: boolean;
+            experimental: boolean;
+        };
+        "placement-group": {
+            type: string;
+            doc: string;
+            transition: boolean;
+            appearance: boolean;
+            expression: {
+                interpolated: boolean;
+                parameters: string[];
+            };
+            "property-type": string;
+            "sdk-support": {
+                "basic functionality": {};
+                "data-driven styling": {};
+            };
+            private: boolean;
+            experimental: boolean;
+        };
     };
     paint_raster: {
         "raster-opacity": {
@@ -9480,21 +9524,6 @@ declare const _exports: {
             };
             "property-type": string;
         };
-        "raster-allow-draping": {
-            type: string;
-            default: boolean;
-            experimental: boolean;
-            doc: string;
-            transition: boolean;
-            "property-type": string;
-            "sdk-support": {
-                "basic functionality": {
-                    js: string;
-                    android: string;
-                    ios: string;
-                };
-            };
-        };
     };
     "paint_raster-particle": {
         "raster-particle-array-band": {
@@ -11429,6 +11458,14 @@ type SymbolLayerSpecification = {
         "icon-color-brightness-max"?: number | ExpressionSpecification;
         "symbol-z-offset"?: DataDrivenPropertyValueSpecification<number>;
         "symbol-z-offset-transition"?: TransitionSpecification;
+        /**
+         * @experimental This property is experimental and subject to change in future versions.
+         */
+        "placement-priority"?: DataDrivenPropertyValueSpecification<number>;
+        /**
+         * @experimental This property is experimental and subject to change in future versions.
+         */
+        "placement-group"?: DataDrivenPropertyValueSpecification<string>;
     };
     "appearances"?: Array<AppearanceSpecification>;
 };
@@ -11772,10 +11809,6 @@ 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-allow-draping"?: boolean;
     };
     "appearances"?: Array<AppearanceSpecification>;
 };
@@ -12014,6 +12047,20 @@ type SlotLayerSpecification = {
     "layout"?: never;
     "paint"?: never;
 };
+type PlacementGroupLayerSpecification = {
+    "id": string;
+    "type": "placement-group";
+    "metadata"?: unknown;
+    "source"?: never;
+    "source-layer"?: never;
+    "slot"?: string;
+    "minzoom"?: never;
+    "maxzoom"?: never;
+    "filter"?: never;
+    "appearances"?: Array<AppearanceSpecification>;
+    "layout"?: never;
+    "paint"?: never;
+};
 type ClipLayerSpecification = {
     "id": string;
     "type": "clip";
@@ -12036,7 +12083,7 @@ type ClipLayerSpecification = {
  * @deprecated Use `ClipLayerSpecification['layout']` instead.
  */
 type ClipLayout = ClipLayerSpecification['layout'];
-type LayerSpecification = FillLayerSpecification | LineLayerSpecification | SymbolLayerSpecification | CircleLayerSpecification | HeatmapLayerSpecification | FillExtrusionLayerSpecification | BuildingLayerSpecification | RasterLayerSpecification | RasterParticleLayerSpecification | HillshadeLayerSpecification | ModelLayerSpecification | BackgroundLayerSpecification | SkyLayerSpecification | SlotLayerSpecification | ClipLayerSpecification;
+type LayerSpecification = FillLayerSpecification | LineLayerSpecification | SymbolLayerSpecification | CircleLayerSpecification | HeatmapLayerSpecification | FillExtrusionLayerSpecification | BuildingLayerSpecification | RasterLayerSpecification | RasterParticleLayerSpecification | HillshadeLayerSpecification | ModelLayerSpecification | BackgroundLayerSpecification | SkyLayerSpecification | SlotLayerSpecification | PlacementGroupLayerSpecification | ClipLayerSpecification;
 type LayoutSpecification = UnionToIntersection<NonNullable<LayerSpecification['layout']>>;
 type PaintSpecification = UnionToIntersection<NonNullable<LayerSpecification['paint']>>;
 type LayerBaseSpecification = Pick<LayerSpecification, "slot" | "minzoom" | "maxzoom" | "filter" | "appearances">;
@@ -12105,6 +12152,10 @@ type SkyLayer = SkyLayerSpecification;
  * @deprecated Use `SlotLayerSpecification` instead.
  */
 type SlotLayer = SlotLayerSpecification;
+/**
+ * @deprecated Use `PlacementGroupLayerSpecification` instead.
+ */
+type PlacementGroupLayer = PlacementGroupLayerSpecification;
 /**
  * @deprecated Use `ClipLayerSpecification` instead.
  */
@@ -12989,4 +13040,4 @@ declare const visit: {
 };
 
 export { Color, ParsingError$1 as ParsingError, ValidationError$1 as ValidationError, export_default as composite, convertFilter, derefLayers, diffStyles as diff, expression, createFilter as featureFilter, format, styleFunction as function, _default as latest, export_default$1 as migrate, _exports as v8, validateStyle as validate, validateMapboxApiSupported, visit };
-export type { AmbientLightSpecification, AnyLayer, AnyLayout, AnyPaint, AnySourceData, AppearanceSpecification, ArrayPropertySpecification, BackgroundLayer, BackgroundLayerSpecification, BackgroundLayout, BackgroundPaint, BooleanPropertySpecification, BuildingLayer, BuildingLayerSpecification, BuildingLayout, BuildingPaint, CameraFunctionSpecification, CameraSpecification, CircleLayer, CircleLayerSpecification, CircleLayout, CirclePaint, ClipLayer, ClipLayerSpecification, ClipLayout, ColorPropertySpecification, ColorSpecification, ColorThemeSpecification, CompositeFunctionSpecification, ConfigSpecification, DataDrivenPropertyValueSpecification, DirectionalLightSpecification, EnumPropertySpecification, Expression$1 as Expression, ExpressionSpecification, FeaturesetSpecification, FeaturesetsSpecification, FillExtrusionLayer, FillExtrusionLayerSpecification, FillExtrusionLayout, FillExtrusionPaint, FillLayer, FillLayerSpecification, FillLayout, FillPaint, FilterSpecification, FlatLightSpecification, FogSpecification, FormattedPropertySpecification, FormattedSpecification, FunctionSpecification, GeoJSONSourceSpecification, HeatmapLayer, HeatmapLayerSpecification, HeatmapLayout, HeatmapPaint, HillshadeLayer, HillshadeLayerSpecification, HillshadeLayout, HillshadePaint, IconsetSpecification, IconsetsSpecification, ImageSourceSpecification, ImportSpecification, IndoorSourceSpecification, IndoorSpecification, Layer, LayerBaseSpecification, LayerSpecification, LayoutSpecification, LightSpecification, LightsSpecification, LineLayer, LineLayerSpecification, LineLayout, LinePaint, ModelLayer, ModelLayerSpecification, ModelLayout, ModelLightOverridesSpecification, ModelMaterialOverrideSpecification, ModelMaterialOverridesSpecification, ModelNodeOverrideSpecification, ModelNodeOverridesSpecification, ModelPaint, ModelSourceModelSpecification, ModelSourceModelsSpecification, ModelSourceSpecification, ModelSpecification, ModelsSpecification, NumberPropertySpecification, OptionSpecification, PaintSpecification, Projection, ProjectionSpecification, PromoteIdSpecification, PropertyExpressionSpecification, PropertyFunctionStop, PropertyValueSpecification, RainSpecification, RasterArraySourceSpecification, RasterDEMSourceSpecification, RasterLayer, RasterLayerSpecification, RasterLayout, RasterPaint, RasterParticleLayer, RasterParticleLayerSpecification, RasterParticleLayout, RasterParticlePaint, RasterSourceSpecification, ResolvedImagePropertySpecification, ResolvedImageSpecification, SchemaSpecification, SelectorPropertySpecification, SelectorSpecification, SkyLayer, SkyLayerSpecification, SkyLayout, SkyPaint, SlotLayer, SlotLayerSpecification, SnowSpecification, SourceFunctionSpecification, SourceSpecification, Sources, SourcesSpecification, StringPropertySpecification, Style, StylePropertySpecification, StyleSpecification, SymbolLayer, SymbolLayerSpecification, SymbolLayout, SymbolPaint, TerrainSpecification, TerrainSpecificationUpdate, Transition, TransitionSpecification, VectorSourceSpecification, VideoSourceSpecification, ZoomAndPropertyFunctionStop };
+export type { AmbientLightSpecification, AnyLayer, AnyLayout, AnyPaint, AnySourceData, AppearanceSpecification, ArrayPropertySpecification, BackgroundLayer, BackgroundLayerSpecification, BackgroundLayout, BackgroundPaint, BooleanPropertySpecification, BuildingLayer, BuildingLayerSpecification, BuildingLayout, BuildingPaint, CameraFunctionSpecification, CameraSpecification, CircleLayer, CircleLayerSpecification, CircleLayout, CirclePaint, ClipLayer, ClipLayerSpecification, ClipLayout, ColorPropertySpecification, ColorSpecification, ColorThemeSpecification, CompositeFunctionSpecification, ConfigSpecification, DataDrivenPropertyValueSpecification, DirectionalLightSpecification, EnumPropertySpecification, Expression$1 as Expression, ExpressionSpecification, FeaturesetSpecification, FeaturesetsSpecification, FillExtrusionLayer, FillExtrusionLayerSpecification, FillExtrusionLayout, FillExtrusionPaint, FillLayer, FillLayerSpecification, FillLayout, FillPaint, FilterSpecification, FlatLightSpecification, FogSpecification, FormattedPropertySpecification, FormattedSpecification, FunctionSpecification, GeoJSONSourceSpecification, HeatmapLayer, HeatmapLayerSpecification, HeatmapLayout, HeatmapPaint, HillshadeLayer, HillshadeLayerSpecification, HillshadeLayout, HillshadePaint, IconsetSpecification, IconsetsSpecification, ImageSourceSpecification, ImportSpecification, IndoorSourceSpecification, IndoorSpecification, Layer, LayerBaseSpecification, LayerSpecification, LayoutSpecification, LightSpecification, LightsSpecification, LineLayer, LineLayerSpecification, LineLayout, LinePaint, ModelLayer, ModelLayerSpecification, ModelLayout, ModelLightOverridesSpecification, ModelMaterialOverrideSpecification, ModelMaterialOverridesSpecification, ModelNodeOverrideSpecification, ModelNodeOverridesSpecification, ModelPaint, ModelSourceModelSpecification, ModelSourceModelsSpecification, ModelSourceSpecification, ModelSpecification, ModelsSpecification, NumberPropertySpecification, OptionSpecification, PaintSpecification, PlacementGroupLayer, PlacementGroupLayerSpecification, Projection, ProjectionSpecification, PromoteIdSpecification, PropertyExpressionSpecification, PropertyFunctionStop, PropertyValueSpecification, RainSpecification, RasterArraySourceSpecification, RasterDEMSourceSpecification, RasterLayer, RasterLayerSpecification, RasterLayout, RasterPaint, RasterParticleLayer, RasterParticleLayerSpecification, RasterParticleLayout, RasterParticlePaint, RasterSourceSpecification, ResolvedImagePropertySpecification, ResolvedImageSpecification, SchemaSpecification, SelectorPropertySpecification, SelectorSpecification, SkyLayer, SkyLayerSpecification, SkyLayout, SkyPaint, SlotLayer, SlotLayerSpecification, SnowSpecification, SourceFunctionSpecification, SourceSpecification, Sources, SourcesSpecification, StringPropertySpecification, Style, StylePropertySpecification, StyleSpecification, SymbolLayer, SymbolLayerSpecification, SymbolLayout, SymbolPaint, TerrainSpecification, TerrainSpecificationUpdate, Transition, TransitionSpecification, VectorSourceSpecification, VideoSourceSpecification, ZoomAndPropertyFunctionStop };

package/dist/index.es.js

@@ -1618,6 +1618,15 @@ var layer = {
 					}
 				}
 			},
+			"placement-group": {
+				doc: "Marks a placement priority group relative to other layers, going from lower to higher priority. Symbols from groups with higher priorities will be placed first",
+				"sdk-support": {
+					"basic functionality": {
+					}
+				},
+				"private": true,
+				experimental: true
+			},
 			clip: {
 				doc: "Layer that removes 3D content from map.",
 				"sdk-support": {
@@ -1638,7 +1647,7 @@ var layer = {
 	},
 	source: {
 		type: "string",
-		doc: "Name of a source description to be used for this layer. Required for all layer types except `background` and `slot`."
+		doc: "Name of a source description to be used for this layer. Required for all layer types except `background`, `slot`, and `placement-group`."
 	},
 	"source-layer": {
 		type: "string",
@@ -9514,6 +9523,60 @@ var paint_symbol = {
 			]
 		},
 		"property-type": "data-driven"
+	},
+	"placement-priority": {
+		type: "number",
+		doc: "In-group placement priority. Higher values are placed first within the symbol's placement group.",
+		"default": 0,
+		minimum: 0,
+		transition: false,
+		appearance: true,
+		expression: {
+			interpolated: true,
+			parameters: [
+				"zoom",
+				"pitch",
+				"feature",
+				"feature-state",
+				"measure-light",
+				"distance-from-center"
+			]
+		},
+		"property-type": "data-driven",
+		"sdk-support": {
+			"basic functionality": {
+			},
+			"data-driven styling": {
+			}
+		},
+		"private": true,
+		experimental: true
+	},
+	"placement-group": {
+		type: "string",
+		doc: "Assigns this symbol layer to the specified placement-group layer, placing its symbols as if they were drawn within that group. When unset, the layer's symbols use an implicitly created placement group located at the same position as the symbol layer.",
+		transition: false,
+		appearance: true,
+		expression: {
+			interpolated: false,
+			parameters: [
+				"zoom",
+				"pitch",
+				"feature",
+				"feature-state",
+				"measure-light",
+				"distance-from-center"
+			]
+		},
+		"property-type": "data-driven",
+		"sdk-support": {
+			"basic functionality": {
+			},
+			"data-driven styling": {
+			}
+		},
+		"private": true,
+		experimental: true
 	}
 };
 var paint_raster = {
@@ -9911,21 +9974,6 @@ var paint_raster = {
 			interpolated: false
 		},
 		"property-type": "data-constant"
-	},
-	"raster-allow-draping": {
-		type: "boolean",
-		"default": true,
-		experimental: true,
-		doc: "Whether the raster layer is allowed to drape over terrain and globe. When disabled, the layer is rendered after all draped layers, which can change its position in the layer order. Disabling draping has a performance cost, since the terrain/globe geometry must be rendered again for each such layer.",
-		transition: false,
-		"property-type": "data-constant",
-		"sdk-support": {
-			"basic functionality": {
-				js: "3.28.0",
-				android: "11.28.0",
-				ios: "11.28.0"
-			}
-		}
 	}
 };
 var paint_hillshade = {
@@ -20348,7 +20396,7 @@ function validateLayer(options) {
     } else {
       type = unbundle(parent.type);
     }
-  } else if (!(type === "background" || type === "sky" || type === "slot")) {
+  } else if (!(type === "background" || type === "sky" || type === "slot" || type === "placement-group")) {
     if (!layer.source) {
       errors.push(new ValidationError(key, layer, 'missing required property "source"'));
     } else if (!isString(layer.source)) {