@mapbox/mapbox-gl-style-spec 14.9.2 → 14.10.0

package/dist/index.d.ts

@@ -43,8 +43,8 @@ type ColorSpecification = string;
 type FormattedSpecification = string;
 type ResolvedImageSpecification = string;
 type PromoteIdSpecification = {
-	[_: string]: string;
-} | string;
+	[_: string]: string | ExpressionSpecification;
+} | string | ExpressionSpecification;
 type FilterSpecification = ExpressionSpecification | [
 	"has",
 	string
@@ -382,15 +382,37 @@ type FeaturesetsSpecification = {
 	[_: string]: FeaturesetSpecification;
 };
 type FeaturesetSpecification = {
+	/**
+	 * @experimental This property is experimental and subject to change in future versions.
+	 */
 	"metadata"?: unknown;
+	/**
+	 * @experimental This property is experimental and subject to change in future versions.
+	 */
 	"selectors"?: Array<SelectorSpecification>;
 };
 type SelectorSpecification = {
+	/**
+	 * @experimental This property is experimental and subject to change in future versions.
+	 */
 	"layer": string;
+	/**
+	 * @experimental This property is experimental and subject to change in future versions.
+	 */
 	"properties"?: SelectorPropertySpecification;
+	/**
+	 * @experimental This property is experimental and subject to change in future versions.
+	 */
 	"featureNamespace"?: string;
+	/**
+	 * @experimental This property is experimental and subject to change in future versions.
+	 */
+	"_uniqueFeatureID"?: boolean;
 };
 type SelectorPropertySpecification = {
+	/**
+	 * @experimental This property is experimental and subject to change in future versions.
+	 */
 	[_: string]: unknown;
 };
 type VectorSourceSpecification = {
@@ -858,6 +880,10 @@ type CircleLayerSpecification = {
 	"filter"?: FilterSpecification;
 	"layout"?: {
 		"circle-sort-key"?: DataDrivenPropertyValueSpecification<number>;
+		/**
+		 * @experimental This property is experimental and subject to change in future versions.
+		 */
+		"circle-elevation-reference"?: "none" | "hd-road-markup" | ExpressionSpecification;
 		"visibility"?: "visible" | "none" | ExpressionSpecification;
 	};
 	"paint"?: {

package/dist/index.es.js

@@ -228,6 +228,13 @@ var $root = {
 		experimental: true,
 		type: "featuresets",
 		doc: "Defines sets of features for querying, interaction, and state management on the map, referencing individual layers or subsets of layers within the map's style.",
+		"sdk-support": {
+			"basic functionality": {
+				js: "3.9.0",
+				android: "11.9.0",
+				ios: "11.9.0"
+			}
+		},
 		example: {
 			poi: {
 				selectors: [
@@ -260,10 +267,12 @@ var featuresets = {
 var featureset = {
 	experimental: true,
 	metadata: {
+		experimental: true,
 		type: "*",
 		doc: "Arbitrary properties useful to track with the stylesheet, but do not influence rendering. Properties should be prefixed to avoid collisions, like 'mapbox:'."
 	},
 	selectors: {
+		experimental: true,
 		type: "array",
 		value: "selector",
 		doc: "A collection of categorized selectors."
@@ -272,24 +281,35 @@ var featureset = {
 var selector = {
 	experimental: true,
 	layer: {
+		experimental: true,
 		type: "string",
 		doc: "The ID of a layer that exists in the current style.",
 		required: true
 	},
 	properties: {
+		experimental: true,
 		type: "selectorProperty",
 		required: false,
 		doc: "Properties accessible to the end user through queried feautures. If properties are empty, no feature properties are exposed. If undefined, all original feature properties will be accessible."
 	},
 	featureNamespace: {
+		experimental: true,
 		type: "string",
 		required: false,
 		doc: "An optional field that represents the feature namespace defined by the selector within a featureset to which this feature belongs. If the underlying source is the same for multiple selectors within a featureset, the same featureNamespace should be used across those selectors."
+	},
+	_uniqueFeatureID: {
+		experimental: true,
+		type: "boolean",
+		"private": true,
+		required: false,
+		doc: "Internal flag used for standard style, in case multiple features sharing the same featureId, only one feature will be returned for feature query."
 	}
 };
 var selectorProperty = {
 	experimental: true,
 	"*": {
+		experimental: true,
 		type: "*",
 		doc: "The value of the property. It can be an expression that generates the returned value from the feature, or a constant value specifying the returned value."
 	}
@@ -1670,6 +1690,31 @@ var layout_circle = {
 		},
 		"property-type": "data-driven"
 	},
+	"circle-elevation-reference": {
+		type: "enum",
+		doc: "Selects the base of circle-elevation. Some modes might require precomputed elevation data in the tileset.",
+		values: {
+			none: {
+				doc: "Elevated rendering is disabled."
+			},
+			"hd-road-markup": {
+				doc: "Elevated rendering is enabled. Use this mode to describe additive and stackable features that should exist only on top of road polygons."
+			}
+		},
+		"default": "none",
+		experimental: true,
+		transition: false,
+		"sdk-support": {
+			"basic functionality": {
+				android: "11.11.0",
+				ios: "11.11.0"
+			}
+		},
+		expression: {
+			interpolated: false
+		},
+		"property-type": "data-constant"
+	},
 	visibility: {
 		type: "enum",
 		values: {
@@ -9284,8 +9329,8 @@ var transition = {
 };
 var promoteId = {
 	"*": {
-		type: "string",
-		doc: "A name of a feature property to use as ID for feature state."
+		type: "*",
+		doc: "A feature property name to use as the ID, or an expression to evaluate as the ID for feature state."
 	}
 };
 var v8 = {
@@ -19758,6 +19803,30 @@ function validateProperty(options, propertyType) {
         return [];
     const useThemeMatch = propertyKey.match(/^(.*)-use-theme$/);
     if (propertyType === 'paint' && useThemeMatch && layerSpec[useThemeMatch[1]]) {
+        if (isExpression(value)) {
+            const errors2 = [];
+            return errors2.concat(validate({
+                key: options.key,
+                value,
+                valueSpec: {
+                    'type': 'string',
+                    'expression': {
+                        'interpolated': false,
+                        'parameters': [
+                            'zoom',
+                            'feature'
+                        ]
+                    },
+                    'property-type': 'data-driven'
+                },
+                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
+            }));
+        }
         return validate({
             key,
             value,
@@ -20087,10 +20156,37 @@ function validatePromoteId({key, value}) {
             key,
             value
         });
+    } else if (Array.isArray(value)) {
+        const errors = [];
+        const unbundledValue = deepUnbundle(value);
+        const expression = createExpression(unbundledValue);
+        if (expression.result === 'error') {
+            expression.value.forEach(err => {
+                errors.push(new ValidationError(`${ key }${ err.key }`, null, `${ err.message }`));
+            });
+        }
+        const parsed = expression.value.expression;
+        const onlyFeatureDependent = isGlobalPropertyConstant(parsed, [
+            'zoom',
+            'heatmap-density',
+            'line-progress',
+            'raster-value',
+            'sky-radial-progress',
+            'accumulated',
+            'is-supported-script',
+            'pitch',
+            'distance-from-center',
+            'measure-light',
+            'raster-particle-speed'
+        ]);
+        if (!onlyFeatureDependent) {
+            errors.push(new ValidationError(`${ key }`, null, 'promoteId expression should be only feature dependent'));
+        }
+        return errors;
     } else {
         const errors = [];
         for (const prop in value) {
-            errors.push(...validateString({
+            errors.push(...validatePromoteId({
                 key: `${ key }.${ prop }`,
                 value: value[prop]
             }));
@@ -21628,7 +21724,8 @@ function getSourceErrors(source, i) {
     const sourceKeys = [
         'type',
         'url',
-        'tileSize'
+        'tileSize',
+        'promoteId'
     ];
     errors.push(...getAllowedKeyErrors(source, sourceKeys, 'source'));
     if (!acceptedSourceTypes.has(String(source.type))) {