@mapbox/mapbox-gl-style-spec 14.27.0 → 14.28.0-rc.1

package/dist/index.d.ts

@@ -1629,7 +1629,6 @@ declare const _exports: {
             type: string;
             value: string;
             "supported-layer-types": string[];
-            experimental: boolean;
             doc: string;
         };
     };
@@ -7956,7 +7955,6 @@ declare const _exports: {
         };
         "line-border-width": {
             type: string;
-            private: boolean;
             doc: string;
             default: number;
             minimum: number;
@@ -7981,7 +7979,6 @@ declare const _exports: {
         };
         "line-border-color": {
             type: string;
-            private: boolean;
             doc: string;
             default: string;
             "use-theme": boolean;
@@ -8004,6 +8001,38 @@ declare const _exports: {
             };
             "property-type": string;
         };
+        "line-border-gradient": {
+            type: string;
+            experimental: boolean;
+            doc: string;
+            example: (string | number | string[])[];
+            "use-theme": boolean;
+            transition: boolean;
+            requires: ({
+                "!": string;
+                source?: undefined;
+                has?: undefined;
+            } | {
+                source: string;
+                has: {
+                    lineMetrics: boolean;
+                };
+                "!"?: undefined;
+            })[];
+            "sdk-support": {
+                "basic functionality": {
+                    js: string;
+                    android: string;
+                    ios: string;
+                };
+                "data-driven styling": {};
+            };
+            expression: {
+                interpolated: boolean;
+                parameters: string[];
+            };
+            "property-type": string;
+        };
         "line-occlusion-opacity": {
             type: string;
             default: number;
@@ -11095,9 +11124,6 @@ type FillLayerSpecification = {
         "fill-tunnel-structure-color-transition"?: TransitionSpecification;
         "fill-tunnel-structure-color-use-theme"?: PropertyValueSpecification<string>;
     };
-    /**
-     * @experimental This property is experimental and subject to change in future versions.
-     */
     "appearances"?: Array<AppearanceSpecification>;
 };
 /**
@@ -11178,6 +11204,11 @@ type LineLayerSpecification = {
         "line-border-color"?: DataDrivenPropertyValueSpecification<ColorSpecification>;
         "line-border-color-transition"?: TransitionSpecification;
         "line-border-color-use-theme"?: PropertyValueSpecification<string>;
+        /**
+         * @experimental This property is experimental and subject to change in future versions.
+         */
+        "line-border-gradient"?: ColorSpecification | ExpressionSpecification;
+        "line-border-gradient-use-theme"?: PropertyValueSpecification<string>;
         "line-occlusion-opacity"?: PropertyValueSpecification<number>;
         "line-occlusion-opacity-transition"?: TransitionSpecification;
         /**
@@ -11189,9 +11220,6 @@ type LineLayerSpecification = {
          */
         "line-blend-additive-clamp"?: PropertyValueSpecification<number>;
     };
-    /**
-     * @experimental This property is experimental and subject to change in future versions.
-     */
     "appearances"?: Array<AppearanceSpecification>;
 };
 /**
@@ -11320,9 +11348,6 @@ type SymbolLayerSpecification = {
         "symbol-z-offset"?: DataDrivenPropertyValueSpecification<number>;
         "symbol-z-offset-transition"?: TransitionSpecification;
     };
-    /**
-     * @experimental This property is experimental and subject to change in future versions.
-     */
     "appearances"?: Array<AppearanceSpecification>;
 };
 /**
@@ -11376,9 +11401,6 @@ type CircleLayerSpecification = {
         "circle-emissive-strength"?: PropertyValueSpecification<number>;
         "circle-emissive-strength-transition"?: TransitionSpecification;
     };
-    /**
-     * @experimental This property is experimental and subject to change in future versions.
-     */
     "appearances"?: Array<AppearanceSpecification>;
 };
 /**
@@ -11413,9 +11435,6 @@ type HeatmapLayerSpecification = {
         "heatmap-opacity"?: PropertyValueSpecification<number>;
         "heatmap-opacity-transition"?: TransitionSpecification;
     };
-    /**
-     * @experimental This property is experimental and subject to change in future versions.
-     */
     "appearances"?: Array<AppearanceSpecification>;
 };
 /**
@@ -11539,9 +11558,6 @@ type FillExtrusionLayerSpecification = {
         "fill-extrusion-line-width-transition"?: TransitionSpecification;
         "fill-extrusion-cast-shadows"?: boolean;
     };
-    /**
-     * @experimental This property is experimental and subject to change in future versions.
-     */
     "appearances"?: Array<AppearanceSpecification>;
 };
 /**
@@ -11611,9 +11627,6 @@ type BuildingLayerSpecification = {
         "building-flood-light-ground-attenuation"?: PropertyValueSpecification<number>;
         "building-flood-light-ground-attenuation-transition"?: TransitionSpecification;
     };
-    /**
-     * @experimental This property is experimental and subject to change in future versions.
-     */
     "appearances"?: Array<AppearanceSpecification>;
 };
 /**
@@ -11674,9 +11687,6 @@ type RasterLayerSpecification = {
          */
         "raster-elevation-reference"?: "sea" | "ground" | ExpressionSpecification;
     };
-    /**
-     * @experimental This property is experimental and subject to change in future versions.
-     */
     "appearances"?: Array<AppearanceSpecification>;
 };
 /**
@@ -11714,9 +11724,6 @@ type RasterParticleLayerSpecification = {
         "raster-particle-elevation"?: PropertyValueSpecification<number>;
         "raster-particle-elevation-transition"?: TransitionSpecification;
     };
-    /**
-     * @experimental This property is experimental and subject to change in future versions.
-     */
     "appearances"?: Array<AppearanceSpecification>;
 };
 /**
@@ -11757,9 +11764,6 @@ type HillshadeLayerSpecification = {
         "hillshade-emissive-strength"?: PropertyValueSpecification<number>;
         "hillshade-emissive-strength-transition"?: TransitionSpecification;
     };
-    /**
-     * @experimental This property is experimental and subject to change in future versions.
-     */
     "appearances"?: Array<AppearanceSpecification>;
 };
 /**
@@ -11821,9 +11825,6 @@ type ModelLayerSpecification = {
          */
         "model-line-cutout-mode"?: "enabled" | "disabled" | "enabled-above-cutout" | ExpressionSpecification;
     };
-    /**
-     * @experimental This property is experimental and subject to change in future versions.
-     */
     "appearances"?: Array<AppearanceSpecification>;
 };
 /**
@@ -11861,9 +11862,6 @@ type BackgroundLayerSpecification = {
         "background-emissive-strength"?: PropertyValueSpecification<number>;
         "background-emissive-strength-transition"?: TransitionSpecification;
     };
-    /**
-     * @experimental This property is experimental and subject to change in future versions.
-     */
     "appearances"?: Array<AppearanceSpecification>;
 };
 /**
@@ -11902,9 +11900,6 @@ type SkyLayerSpecification = {
         "sky-opacity"?: PropertyValueSpecification<number>;
         "sky-opacity-transition"?: TransitionSpecification;
     };
-    /**
-     * @experimental This property is experimental and subject to change in future versions.
-     */
     "appearances"?: Array<AppearanceSpecification>;
 };
 /**
@@ -11925,9 +11920,6 @@ type SlotLayerSpecification = {
     "minzoom"?: never;
     "maxzoom"?: never;
     "filter"?: never;
-    /**
-     * @experimental This property is experimental and subject to change in future versions.
-     */
     "appearances"?: Array<AppearanceSpecification>;
     "layout"?: never;
     "paint"?: never;
@@ -11947,9 +11939,6 @@ type ClipLayerSpecification = {
         "clip-layer-scope"?: Array<string> | ExpressionSpecification;
         "visibility"?: "visible" | "none" | ExpressionSpecification;
     };
-    /**
-     * @experimental This property is experimental and subject to change in future versions.
-     */
     "appearances"?: Array<AppearanceSpecification>;
     "paint"?: never;
 };

package/dist/index.es.js

@@ -1675,8 +1675,7 @@ var layer = {
 		"supported-layer-types": [
 			"symbol"
 		],
-		experimental: true,
-		doc: "Conditional styling applied to symbol layer features based on dynamic conditions. If multiple conditions are true, only the first matching appearance will be applied. Only properties marked with 'Works with appearances' are supported."
+		doc: "Conditional styling applied to symbol layer features based on dynamic conditions. If multiple conditions are true, only the first matching appearance will be applied. Only properties marked with 'Works with appearances' are supported. Known issue: at the moment having both `appearances` and `text-variable-anchor` in the same layer doesn't work correctly."
 	}
 };
 var appearance = {
@@ -3913,7 +3912,7 @@ var layout_symbol = {
 				]
 			}
 		],
-		doc: "To increase the chance of placing high-priority labels on the map, you can provide an array of `text-anchor` locations: the renderer will attempt to place the label at each location, in order, before moving onto the next label. Use `text-justify: auto` to choose justification based on anchor position. To apply an offset, use the `text-radial-offset` or the two-dimensional `text-offset`.",
+		doc: "To increase the chance of placing high-priority labels on the map, you can provide an array of `text-anchor` locations: the renderer will attempt to place the label at each location, in order, before moving onto the next label. Use `text-justify: auto` to choose justification based on anchor position. To apply an offset, use the `text-radial-offset` or the two-dimensional `text-offset`. Known issue: at the moment having both `appearances` and `text-variable-anchor` in the same layer doesn't work correctly.",
 		"sdk-support": {
 			"basic functionality": {
 				js: "0.54.0",
@@ -8088,7 +8087,6 @@ var paint_line = {
 	},
 	"line-border-width": {
 		type: "number",
-		"private": true,
 		doc: "The width of the line border. A value of zero means no border.",
 		"default": 0,
 		minimum: 0,
@@ -8117,7 +8115,6 @@ var paint_line = {
 	},
 	"line-border-color": {
 		type: "color",
-		"private": true,
 		doc: "The color of the line border. If line-border-width is greater than zero and the alpha value of this color is 0 (default), the color for the border will be selected automatically based on the line color.",
 		"default": "rgba(0, 0, 0, 0)",
 		"use-theme": true,
@@ -8144,6 +8141,49 @@ var paint_line = {
 		},
 		"property-type": "data-driven"
 	},
+	"line-border-gradient": {
+		type: "color",
+		experimental: true,
+		doc: "A gradient used to color the border of a line feature at various distances along its length. Defined using a `step` or `interpolate` expression which outputs a color for each corresponding `line-progress` input value. `line-progress` is a percentage of the line feature's total length as measured on the webmercator projected coordinate plane (a `number` between `0` and `1`). Takes precedence over `line-border-color`. Has no effect unless `line-border-width` is greater than zero. Can only be used with GeoJSON sources that specify `\"lineMetrics\": true`.",
+		example: [
+			"step",
+			[
+				"line-progress"
+			],
+			"blue",
+			0.5,
+			"gray"
+		],
+		"use-theme": true,
+		transition: false,
+		requires: [
+			{
+				"!": "line-pattern"
+			},
+			{
+				source: "geojson",
+				has: {
+					lineMetrics: true
+				}
+			}
+		],
+		"sdk-support": {
+			"basic functionality": {
+				js: "3.28.0",
+				android: "11.28.0",
+				ios: "11.28.0"
+			},
+			"data-driven styling": {
+			}
+		},
+		expression: {
+			interpolated: true,
+			parameters: [
+				"line-progress"
+			]
+		},
+		"property-type": "color-ramp"
+	},
 	"line-occlusion-opacity": {
 		type: "number",
 		"default": 0,
@@ -13190,7 +13230,9 @@ class ResolvedImage {
     return new ImageVariant(this.secondaryId, this.secondaryOptions);
   }
   static from(image) {
-    return typeof image === "string" ? ResolvedImage.build({ name: image }) : image;
+    if (typeof image !== "string") return image;
+    const resolved = ResolvedImage.build({ name: image });
+    return resolved;
   }
   static build(primaryId, secondaryId, primaryOptions, secondaryOptions) {
     if (!primaryId || typeof primaryId === "object" && !("name" in primaryId)) return null;
@@ -15534,9 +15576,7 @@ class Config {
   }
   static parse(args, context) {
     let type = context.expectedType;
-    if (type === null || type === void 0) {
-      type = ValueType;
-    }
+    type ?? (type = ValueType);
     if (args.length < 2 || args.length > 3) {
       return context.error(`Invalid number of arguments for 'config' expression.`);
     }
@@ -16493,112 +16533,6 @@ class AtInterpolated {
   }
 }
 
-class In {
-  constructor(needle, haystack) {
-    this.type = BooleanType;
-    this.needle = needle;
-    this.haystack = haystack;
-  }
-  static parse(args, context) {
-    if (args.length !== 3) {
-      context.error(`Expected 2 arguments, but found ${args.length - 1} instead.`);
-      return null;
-    }
-    const needle = context.parse(args[1], 1, ValueType);
-    const haystack = context.parse(args[2], 2, ValueType);
-    if (!needle || !haystack) return null;
-    if (!isValidType(needle.type, [BooleanType, StringType, NumberType, NullType, ValueType])) {
-      context.error(`Expected first argument to be of type boolean, string, number or null, but found ${toString$1(needle.type)} instead`);
-      return null;
-    }
-    return new In(needle, haystack);
-  }
-  evaluate(ctx) {
-    const needle = this.needle.evaluate(ctx);
-    const haystack = this.haystack.evaluate(ctx);
-    if (haystack == null) return false;
-    if (!isValidNativeType(needle, ["boolean", "string", "number", "null"])) {
-      throw new RuntimeError(`Expected first argument to be of type boolean, string, number or null, but found ${toString$1(typeOf(needle))} instead.`);
-    }
-    if (!isValidNativeType(haystack, ["string", "array"])) {
-      throw new RuntimeError(`Expected second argument to be of type array or string, but found ${toString$1(typeOf(haystack))} instead.`);
-    }
-    return haystack.includes(needle);
-  }
-  eachChild(fn) {
-    fn(this.needle);
-    fn(this.haystack);
-  }
-  outputDefined() {
-    return true;
-  }
-  serialize() {
-    return ["in", this.needle.serialize(), this.haystack.serialize()];
-  }
-}
-
-class IndexOf {
-  constructor(needle, haystack, fromIndex) {
-    this.type = NumberType;
-    this.needle = needle;
-    this.haystack = haystack;
-    this.fromIndex = fromIndex;
-  }
-  static parse(args, context) {
-    if (args.length <= 2 || args.length >= 5) {
-      context.error(`Expected 3 or 4 arguments, but found ${args.length - 1} instead.`);
-      return null;
-    }
-    const needle = context.parse(args[1], 1, ValueType);
-    const haystack = context.parse(args[2], 2, ValueType);
-    if (!needle || !haystack) return null;
-    if (!isValidType(needle.type, [BooleanType, StringType, NumberType, NullType, ValueType])) {
-      context.error(`Expected first argument to be of type boolean, string, number or null, but found ${toString$1(needle.type)} instead`);
-      return null;
-    }
-    if (args.length === 4) {
-      const fromIndex = context.parse(args[3], 3, NumberType);
-      if (!fromIndex) return null;
-      return new IndexOf(needle, haystack, fromIndex);
-    } else {
-      return new IndexOf(needle, haystack);
-    }
-  }
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  evaluate(ctx) {
-    const needle = this.needle.evaluate(ctx);
-    const haystack = this.haystack.evaluate(ctx);
-    if (!isValidNativeType(needle, ["boolean", "string", "number", "null"])) {
-      throw new RuntimeError(`Expected first argument to be of type boolean, string, number or null, but found ${toString$1(typeOf(needle))} instead.`);
-    }
-    if (!isValidNativeType(haystack, ["string", "array"])) {
-      throw new RuntimeError(`Expected second argument to be of type array or string, but found ${toString$1(typeOf(haystack))} instead.`);
-    }
-    if (this.fromIndex) {
-      const fromIndex = this.fromIndex.evaluate(ctx);
-      return haystack.indexOf(needle, fromIndex);
-    }
-    return haystack.indexOf(needle);
-  }
-  eachChild(fn) {
-    fn(this.needle);
-    fn(this.haystack);
-    if (this.fromIndex) {
-      fn(this.fromIndex);
-    }
-  }
-  outputDefined() {
-    return false;
-  }
-  serialize() {
-    if (this.fromIndex != null && this.fromIndex !== void 0) {
-      const fromIndex = this.fromIndex.serialize();
-      return ["index-of", this.needle.serialize(), this.haystack.serialize(), fromIndex];
-    }
-    return ["index-of", this.needle.serialize(), this.haystack.serialize()];
-  }
-}
-
 class Match {
   constructor(inputType, outputType, input, cases, outputs, otherwise) {
     this.inputType = inputType;
@@ -16821,38 +16755,6 @@ class Slice {
   }
 }
 
-class Split {
-  constructor(str, delimiter) {
-    this.type = array$1(StringType);
-    this.str = str;
-    this.delimiter = delimiter;
-  }
-  static parse(args, context) {
-    if (args.length !== 3) {
-      return context.error(`Expected 2 arguments, but found ${args.length - 1} instead.`);
-    }
-    const str = context.parse(args[1], 1, StringType);
-    const delimiter = context.parse(args[2], 2, StringType);
-    if (!str || !delimiter) return;
-    return new Split(str, delimiter);
-  }
-  evaluate(ctx) {
-    const str = this.str.evaluate(ctx);
-    const delimiter = this.delimiter.evaluate(ctx);
-    return str.split(delimiter);
-  }
-  eachChild(fn) {
-    fn(this.str);
-    fn(this.delimiter);
-  }
-  outputDefined() {
-    return false;
-  }
-  serialize() {
-    return ["split", this.str.serialize(), this.delimiter.serialize()];
-  }
-}
-
 function isComparableType(op, type) {
   if (op === "==" || op === "!=") {
     return type.kind === "boolean" || type.kind === "string" || type.kind === "number" || type.kind === "null" || type.kind === "value";
@@ -17160,8 +17062,6 @@ const expressions = {
   "collator": CollatorExpression,
   "format": FormatExpression,
   "image": ImageExpression,
-  "in": In,
-  "index-of": IndexOf,
   "interpolate": Interpolate,
   "interpolate-hcl": Interpolate,
   "interpolate-lab": Interpolate,
@@ -17182,8 +17082,7 @@ const expressions = {
   "var": Var,
   "within": Within,
   "distance": Distance,
-  "config": Config,
-  "split": Split
+  "config": Config
 };
 function rgba(ctx, [r, g, b, a]) {
   r = r.evaluate(ctx);
@@ -17228,6 +17127,14 @@ function binarySearch(v, a, i, j) {
 function varargs(type) {
   return { type };
 }
+function assertNeedleHaystack(needle, haystack) {
+  if (!isValidNativeType(needle, ["boolean", "string", "number", "null"])) {
+    throw new RuntimeError(`Expected first argument to be of type boolean, string, number or null, but found ${toString$1(typeOf(needle))} instead.`);
+  }
+  if (!isValidNativeType(haystack, ["string", "array"])) {
+    throw new RuntimeError(`Expected second argument to be of type array or string, but found ${toString$1(typeOf(haystack))} instead.`);
+  }
+}
 function hashString(str) {
   let hash = 0;
   if (str.length === 0) {
@@ -17777,6 +17684,47 @@ CompoundExpression.register(expressions, {
     // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
     (ctx, args) => args.map((arg) => toString(arg.evaluate(ctx))).join("")
   ],
+  "split": [
+    array$1(StringType),
+    [StringType, StringType],
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-return
+    (ctx, [str, delimiter]) => str.evaluate(ctx).split(delimiter.evaluate(ctx))
+  ],
+  "in": [
+    BooleanType,
+    [ValueType, ValueType],
+    (ctx, [needleExpr, haystackExpr]) => {
+      const needle = needleExpr.evaluate(ctx);
+      const haystack = haystackExpr.evaluate(ctx);
+      if (haystack == null) return false;
+      assertNeedleHaystack(needle, haystack);
+      return haystack.includes(needle);
+    }
+  ],
+  "index-of": {
+    type: NumberType,
+    overloads: [
+      [
+        [ValueType, ValueType],
+        (ctx, [needleExpr, haystackExpr]) => {
+          const needle = needleExpr.evaluate(ctx);
+          const haystack = haystackExpr.evaluate(ctx);
+          assertNeedleHaystack(needle, haystack);
+          return haystack.indexOf(needle);
+        }
+      ],
+      [
+        [ValueType, ValueType, NumberType],
+        (ctx, [needleExpr, haystackExpr, fromIndexExpr]) => {
+          const needle = needleExpr.evaluate(ctx);
+          const haystack = haystackExpr.evaluate(ctx);
+          const fromIndex = fromIndexExpr.evaluate(ctx);
+          assertNeedleHaystack(needle, haystack);
+          return haystack.indexOf(needle, fromIndex);
+        }
+      ]
+    ]
+  },
   "resolved-locale": [
     StringType,
     [CollatorType],
@@ -19517,7 +19465,7 @@ class ParsingError {
     this.error = error;
     this.message = error.message;
     const match = error.message.match(LINE_NUMBER_RE);
-    this.line = match ? parseInt(match[1], 10) : 0;
+    this.line = match && match[1] ? parseInt(match[1], 10) : 0;
   }
 }