@mapbox/mapbox-gl-style-spec 14.14.0-beta.2 → 14.14.0

package/dist/index.d.ts

@@ -24,21 +24,6 @@ declare const _default: StyleReference;
  * fs.writeFileSync('./dest.min.json', format(style, 0));
  */
 export declare function format(style: any, space?: number): string;
-/**
- * Migrate a Mapbox GL Style to the latest version.
- *
- * @private
- * @alias migrate
- * @param {object} style a Mapbox GL Style
- * @returns {Object} a migrated style
- * @example
- * var fs = require('fs');
- * var migrate = require('mapbox-gl-style-spec').migrate;
- * var style = fs.readFileSync('./style.json', 'utf8');
- * fs.writeFileSync('./style.json', JSON.stringify(migrate(style)));
- */
-declare function _default$1(style: any): any;
-declare function _default$2(style: any): any;
 type ColorSpecification = string;
 type FormattedSpecification = string;
 type ResolvedImageSpecification = string;
@@ -479,6 +464,11 @@ type SelectorPropertySpecification = {
 	 */
 	[_: string]: unknown;
 };
+type AppearanceSpecification = {
+	"condition"?: ExpressionSpecification;
+	"name"?: string;
+	"properties"?: unknown;
+};
 type VectorSourceSpecification = {
 	"type": "vector";
 	"url"?: string;
@@ -778,6 +768,7 @@ type FillLayerSpecification = {
 		"fill-tunnel-structure-color-transition"?: TransitionSpecification;
 		"fill-tunnel-structure-color-use-theme"?: PropertyValueSpecification<string>;
 	};
+	"appearances"?: Array<AppearanceSpecification>;
 };
 type LineLayerSpecification = {
 	"id": string;
@@ -865,6 +856,7 @@ type LineLayerSpecification = {
 		"line-occlusion-opacity"?: PropertyValueSpecification<number>;
 		"line-occlusion-opacity-transition"?: TransitionSpecification;
 	};
+	"appearances"?: Array<AppearanceSpecification>;
 };
 type SymbolLayerSpecification = {
 	"id": string;
@@ -1000,6 +992,7 @@ type SymbolLayerSpecification = {
 		"symbol-z-offset"?: DataDrivenPropertyValueSpecification<number>;
 		"symbol-z-offset-transition"?: TransitionSpecification;
 	};
+	"appearances"?: Array<AppearanceSpecification>;
 };
 type CircleLayerSpecification = {
 	"id": string;
@@ -1047,6 +1040,7 @@ type CircleLayerSpecification = {
 		"circle-emissive-strength"?: PropertyValueSpecification<number>;
 		"circle-emissive-strength-transition"?: TransitionSpecification;
 	};
+	"appearances"?: Array<AppearanceSpecification>;
 };
 type HeatmapLayerSpecification = {
 	"id": string;
@@ -1072,6 +1066,7 @@ type HeatmapLayerSpecification = {
 		"heatmap-opacity"?: PropertyValueSpecification<number>;
 		"heatmap-opacity-transition"?: TransitionSpecification;
 	};
+	"appearances"?: Array<AppearanceSpecification>;
 };
 type FillExtrusionLayerSpecification = {
 	"id": string;
@@ -1181,6 +1176,7 @@ type FillExtrusionLayerSpecification = {
 		"fill-extrusion-line-width-transition"?: TransitionSpecification;
 		"fill-extrusion-cast-shadows"?: boolean;
 	};
+	"appearances"?: Array<AppearanceSpecification>;
 };
 type BuildingLayerSpecification = {
 	"id": string;
@@ -1274,6 +1270,7 @@ type BuildingLayerSpecification = {
 		"building-facade-emissive-chance"?: PropertyValueSpecification<number>;
 		"building-cutoff-fade-range"?: ExpressionSpecification;
 	};
+	"appearances"?: Array<AppearanceSpecification>;
 };
 type RasterLayerSpecification = {
 	"id": string;
@@ -1329,6 +1326,7 @@ type RasterLayerSpecification = {
 		"raster-elevation"?: PropertyValueSpecification<number>;
 		"raster-elevation-transition"?: TransitionSpecification;
 	};
+	"appearances"?: Array<AppearanceSpecification>;
 };
 type RasterParticleLayerSpecification = {
 	"id": string;
@@ -1357,6 +1355,7 @@ type RasterParticleLayerSpecification = {
 		"raster-particle-elevation"?: PropertyValueSpecification<number>;
 		"raster-particle-elevation-transition"?: TransitionSpecification;
 	};
+	"appearances"?: Array<AppearanceSpecification>;
 };
 type HillshadeLayerSpecification = {
 	"id": string;
@@ -1388,6 +1387,7 @@ type HillshadeLayerSpecification = {
 		"hillshade-emissive-strength"?: PropertyValueSpecification<number>;
 		"hillshade-emissive-strength-transition"?: TransitionSpecification;
 	};
+	"appearances"?: Array<AppearanceSpecification>;
 };
 type ModelLayerSpecification = {
 	"id": string;
@@ -1453,6 +1453,7 @@ type ModelLayerSpecification = {
 			number
 		]>;
 	};
+	"appearances"?: Array<AppearanceSpecification>;
 };
 type BackgroundLayerSpecification = {
 	"id": string;
@@ -1481,6 +1482,7 @@ type BackgroundLayerSpecification = {
 		"background-emissive-strength"?: PropertyValueSpecification<number>;
 		"background-emissive-strength-transition"?: TransitionSpecification;
 	};
+	"appearances"?: Array<AppearanceSpecification>;
 };
 type SkyLayerSpecification = {
 	"id": string;
@@ -1516,6 +1518,7 @@ type SkyLayerSpecification = {
 		"sky-opacity"?: PropertyValueSpecification<number>;
 		"sky-opacity-transition"?: TransitionSpecification;
 	};
+	"appearances"?: Array<AppearanceSpecification>;
 };
 type SlotLayerSpecification = {
 	"id": string;
@@ -1527,6 +1530,7 @@ type SlotLayerSpecification = {
 	"minzoom"?: never;
 	"maxzoom"?: never;
 	"filter"?: never;
+	"appearances"?: Array<AppearanceSpecification>;
 	"layout"?: never;
 	"paint"?: never;
 };
@@ -1544,9 +1548,27 @@ type ClipLayerSpecification = {
 		"clip-layer-types"?: ExpressionSpecification;
 		"clip-layer-scope"?: ExpressionSpecification;
 	};
+	"appearances"?: Array<AppearanceSpecification>;
 	"paint"?: never;
 };
 type LayerSpecification = FillLayerSpecification | LineLayerSpecification | SymbolLayerSpecification | CircleLayerSpecification | HeatmapLayerSpecification | FillExtrusionLayerSpecification | BuildingLayerSpecification | RasterLayerSpecification | RasterParticleLayerSpecification | HillshadeLayerSpecification | ModelLayerSpecification | BackgroundLayerSpecification | SkyLayerSpecification | SlotLayerSpecification | ClipLayerSpecification;
+/**
+ * Migrate a Mapbox GL Style to the latest version.
+ *
+ * @private
+ * @alias migrate
+ * @param {object} style a Mapbox GL Style
+ * @returns {Object} a migrated style
+ * @example
+ * var fs = require('fs');
+ * var migrate = require('mapbox-gl-style-spec').migrate;
+ * var style = fs.readFileSync('./style.json', 'utf8');
+ * fs.writeFileSync('./style.json', JSON.stringify(migrate(style)));
+ */
+declare function _default$1(style: {
+	version: 7;
+} | StyleSpecification): StyleSpecification;
+declare function _default$2(style: StyleSpecification): StyleSpecification;
 /**
  * Given an array of layers, some of which may contain `ref` properties
  * whose value is the `id` of another property, return a new array where

package/dist/index.es.js

@@ -1507,6 +1507,29 @@ var layer = {
 	paint: {
 		type: "paint",
 		doc: "Default paint properties for this layer."
+	},
+	appearances: {
+		type: "array",
+		value: "appearance",
+		"supported-layer-types": [
+			"symbol"
+		],
+		"private": true,
+		doc: "Conditional styling applied to layer features based on dynamic conditions. If multiple conditions are true, only the first matching appearance will be applied. Only properties marked with 'Can be used in appearances' are supported."
+	}
+};
+var appearance = {
+	condition: {
+		type: "expression",
+		doc: "A boolean expression that determines when this appearance should be applied."
+	},
+	name: {
+		type: "string",
+		doc: "Optional name for this appearance. Non-empty names should be unique within a layer."
+	},
+	properties: {
+		type: "*",
+		doc: "Style properties to apply when the condition is met."
 	}
 };
 var layout = [
@@ -2698,6 +2721,7 @@ var layout_symbol = {
 		minimum: 0,
 		units: "factor of the original icon size",
 		doc: "Scales the original size of the icon by the provided factor. The new pixel size of the image will be the original pixel size multiplied by `icon-size`. 1 is the original size; 3 triples the size of the image.",
+		appearance: true,
 		requires: [
 			"icon-image"
 		],
@@ -2841,6 +2865,7 @@ var layout_symbol = {
 		type: "resolvedImage",
 		doc: "Name of image in sprite to use for drawing an image background.",
 		tokens: true,
+		appearance: true,
 		"sdk-support": {
 			"basic functionality": {
 				js: "0.10.0",
@@ -2868,6 +2893,7 @@ var layout_symbol = {
 		period: 360,
 		units: "degrees",
 		doc: "Rotates the icon clockwise.",
+		appearance: true,
 		requires: [
 			"icon-image"
 		],
@@ -2956,6 +2982,7 @@ var layout_symbol = {
 			0
 		],
 		doc: "Offset distance of icon from its anchor. Positive values indicate right and down, while negative values indicate left and up. Each component is multiplied by the value of `icon-size` to obtain the final offset in pixels. When combined with `icon-rotate` the offset will be as if the rotated direction was up.",
+		appearance: true,
 		requires: [
 			"icon-image"
 		],
@@ -10182,6 +10209,7 @@ var v8 = {
 	source_image: source_image,
 	source_model: source_model,
 	layer: layer,
+	appearance: appearance,
 	layout: layout,
 	layout_background: layout_background,
 	layout_sky: layout_sky,
@@ -18000,7 +18028,6 @@ CompoundExpression.register(expressions, {
         overloads: [
             [
                 [StringType],
-                // eslint-disable-next-line @typescript-eslint/no-unsafe-return
                 (ctx, [key]) => get(key.evaluate(ctx), ctx.properties())
             ],
             [
@@ -18016,7 +18043,6 @@ 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': [
@@ -19802,11 +19828,11 @@ function migrate (style) {
         migrated = true;
     }
     if (style.version === 8) {
-        migrated = migrateToExpressions(style);
+        style = migrateToExpressions(style);
         migrated = true;
     }
     if (!migrated) {
-        throw new Error('cannot migrate from', style.version);
+        throw new Error(`Cannot migrate from ${ style.version }`);
     }
     return style;
 }
@@ -21109,7 +21135,6 @@ function validateProperty(options, propertyType) {
                 },
                 style,
                 styleSpec,
-                // @ts-expect-error - TS2353 - Object literal may only specify known properties, and 'expressionContext' does not exist in type 'ValidationOptions'.
                 expressionContext: 'property',
                 propertyType,
                 propertyKey
@@ -21168,7 +21193,6 @@ Use an identity property function instead: ${ example }.`)];
         valueSpec,
         style,
         styleSpec,
-        // @ts-expect-error - TS2353 - Object literal may only specify known properties, and 'expressionContext' does not exist in type 'ValidationOptions'.
         expressionContext: 'property',
         propertyType,
         propertyKey
@@ -21821,9 +21845,7 @@ function validateIconset(options) {
 }
 
 const VALIDATORS = {
-    '*'() {
-        return [];
-    },
+    '*': () => [],
     'array': validateArray,
     'boolean': validateBoolean,
     'number': validateNumber,