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

package/dist/index.cjs

@@ -1681,8 +1681,7 @@
   		"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 = {
@@ -3919,7 +3918,7 @@
   				]
   			}
   		],
-  		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",
@@ -8094,7 +8093,6 @@
   	},
   	"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,
@@ -8123,7 +8121,6 @@
   	},
   	"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,
@@ -8150,6 +8147,49 @@
   		},
   		"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,
@@ -13196,7 +13236,9 @@
       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;
@@ -15540,9 +15582,7 @@
     }
     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.`);
       }
@@ -16499,112 +16539,6 @@
     }
   }
 
-  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;
@@ -16827,38 +16761,6 @@
     }
   }
 
-  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";
@@ -17166,8 +17068,6 @@
     "collator": CollatorExpression,
     "format": FormatExpression,
     "image": ImageExpression,
-    "in": In,
-    "index-of": IndexOf,
     "interpolate": Interpolate,
     "interpolate-hcl": Interpolate,
     "interpolate-lab": Interpolate,
@@ -17188,8 +17088,7 @@
     "var": Var,
     "within": Within,
     "distance": Distance,
-    "config": Config,
-    "split": Split
+    "config": Config
   };
   function rgba(ctx, [r, g, b, a]) {
     r = r.evaluate(ctx);
@@ -17234,6 +17133,14 @@
   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) {
@@ -17783,6 +17690,47 @@
       // 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],
@@ -19523,7 +19471,7 @@ ${JSON.stringify(filterExp, null, 2)}
       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;
     }
   }