@mapbox/mapbox-gl-style-spec 14.18.0 → 14.19.0-beta.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mapbox/mapbox-gl-style-spec",
-  "version": "14.18.0",
+  "version": "14.19.0-beta.1",
   "description": "a specification for mapbox gl styles",
   "author": "Mapbox",
   "license": "SEE LICENSE IN LICENSE.txt",

package/reference/v8.json

@@ -1904,6 +1904,30 @@
         "interpolated": false
       },
       "property-type": "data-constant"
+    },
+    "visibility": {
+      "type": "enum",
+      "values": {
+        "visible": {
+          "doc": "The layer is shown."
+        },
+        "none": {
+          "doc": "The layer is not shown."
+        }
+      },
+      "default": "visible",
+      "doc": "Whether this layer is displayed.",
+      "sdk-support": {
+        "basic functionality": {
+          "js": "3.18.0",
+          "android": "11.18.0",
+          "ios": "11.18.0"
+        }
+      },
+      "expression": {
+        "interpolated": false
+      },
+      "property-type": "data-constant"
     }
   },
   "layout_fill": {
@@ -2814,6 +2838,38 @@
         ]
       },
       "property-type": "data-constant"
+    },
+    "line-elevation-ground-scale": {
+      "type": "number",
+      "default": 0,
+      "minimum": 0,
+      "maximum": 1,
+      "doc": "Controls how much the elevation of lines with `line-elevation-reference` set to `sea` scales with terrain exaggeration. A value of 0 keeps the line at a fixed altitude above sea level. A value of 1 scales the elevation proportionally with terrain exaggeration.",
+      "sdk-support": {
+        "basic functionality": {
+          "js": "3.19.0",
+          "android": "11.19.0",
+          "ios": "11.19.0"
+        },
+        "data-driven styling": {
+          "js": "3.19.0",
+          "android": "11.19.0",
+          "ios": "11.19.0"
+        }
+      },
+      "expression": {
+        "interpolated": true,
+        "parameters": [
+          "zoom",
+          "feature",
+          "line-progress"
+        ]
+      },
+      "requires": [
+        "line-z-offset"
+      ],
+      "transition": true,
+      "property-type": "data-driven"
     }
   },
   "layout_symbol": {
@@ -10363,7 +10419,7 @@
     },
     "raster-elevation": {
       "type": "number",
-      "doc": "Specifies an uniform elevation from the ground, in meters.",
+      "doc": "Defines an uniform elevation from the base specified in raster-elevation-reference, in meters.",
       "default": 0,
       "minimum": 0,
       "transition": true,
@@ -10382,6 +10438,32 @@
         ]
       },
       "property-type": "data-constant"
+    },
+    "raster-elevation-reference": {
+      "type": "enum",
+      "doc": "Selects the base of raster-elevation.",
+      "values": {
+        "sea": {
+          "doc": "Use this mode to elevate raster layers relative to the sea level."
+        },
+        "ground": {
+          "doc": "Use this mode to elevate raster layers relative to the ground's height below them."
+        }
+      },
+      "default": "sea",
+      "transition": false,
+      "experimental": true,
+      "sdk-support": {
+        "basic functionality": {
+          "js": "3.19.0",
+          "android": "11.19.0",
+          "ios": "11.19.0"
+        }
+      },
+      "expression": {
+        "interpolated": false
+      },
+      "property-type": "data-constant"
     }
   },
   "paint_raster-particle": {
@@ -10513,7 +10595,7 @@
     },
     "raster-particle-elevation": {
       "type": "number",
-      "doc": "Specifies an uniform elevation from the ground, in meters.",
+      "doc": "Defines an uniform elevation from sea level, in meters.",
       "default": 0,
       "minimum": 0,
       "transition": true,
@@ -11405,7 +11487,7 @@
     },
     "model-elevation-reference": {
       "type": "enum",
-      "doc": "Selects the base of the model. Some modes might require precomputed elevation data in the tileset.",
+      "doc": "Selects the base of the model. Some modes might require precomputed elevation data in the tileset. When using vector tiled source as the model layer source and hd-road-markup elevation reference, this property acts as layout property and elevation is evaluated only in tile loading time.",
       "values": {
         "sea": {
           "doc": "Elevated rendering is enabled. Use this mode to elevate models relative to the sea level."

package/types.ts

@@ -716,7 +716,9 @@ export type LineLayerSpecification = {
         /**
          * @experimental This property is experimental and subject to change in future versions.
          */
-        "line-width-unit"?: PropertyValueSpecification<"pixels" | "meters">
+        "line-width-unit"?: PropertyValueSpecification<"pixels" | "meters">,
+        "line-elevation-ground-scale"?: DataDrivenPropertyValueSpecification<number>,
+        "line-elevation-ground-scale-transition"?: TransitionSpecification
     },
     "paint"?: {
         "line-opacity"?: DataDrivenPropertyValueSpecification<number>,
@@ -1246,7 +1248,11 @@ export type RasterLayerSpecification = {
          * @experimental This property is experimental and subject to change in future versions.
          */
         "raster-elevation"?: PropertyValueSpecification<number>,
-        "raster-elevation-transition"?: TransitionSpecification
+        "raster-elevation-transition"?: TransitionSpecification,
+        /**
+         * @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.
@@ -1533,7 +1539,8 @@ export type ClipLayerSpecification = {
     "filter"?: FilterSpecification,
     "layout"?: {
         "clip-layer-types"?: Array<"model" | "symbol"> | ExpressionSpecification,
-        "clip-layer-scope"?: Array<string> | ExpressionSpecification
+        "clip-layer-scope"?: Array<string> | ExpressionSpecification,
+        "visibility"?: "visible" | "none" | ExpressionSpecification
     },
     /**
      * @experimental This property is experimental and subject to change in future versions.

package/util/color.ts

@@ -129,6 +129,11 @@ export abstract class RenderColor {
                 b = b * (N - 1);
             }
 
+            // Clamp to valid range [0, N-1] to prevent out-of-bounds access
+            r = Math.max(0, Math.min(N - 1, r));
+            g = Math.max(0, Math.min(N - 1, g));
+            b = Math.max(0, Math.min(N - 1, b));
+
             // Determine boundary values for the cube the color is in.
             const r0 = Math.floor(r);
             const g0 = Math.floor(g);
@@ -151,9 +156,6 @@ export abstract class RenderColor {
             const i5 = (r1 + g0 * N2 + b1 * N) * 4;
             const i6 = (r1 + g1 * N2 + b0 * N) * 4;
             const i7 = (r1 + g1 * N2 + b1 * N) * 4;
-            if (i0 < 0 || i7 >= data.length) {
-                throw new Error("out of range");
-            }
 
             // Trilinear interpolation.
             this.r = lerp(