[MAPS3D-2186] Promote elevated lines properties to stable: line-z-offset and line-elevation-reference (#9756)

Closes [MAPS3D-2186](https://mapbox.atlassian.net/browse/MAPS3D-2186)

This PR removes the experimental flag from the elevated lines properties
`line-z-offset` and `line-elevation-reference`. The property
`line-cross-slope` will remain experimental for now, as we might still
want to change how it works in the future.

[MAPS3D-2186]:
https://mapbox.atlassian.net/browse/MAPS3D-2186?atlOrigin=eyJpIjoiNWRkNTljNzYxNjVmNDY3MDlhMDU5Y2ZhYzA5YTRkZjUiLCJwIjoiZ2l0aHViLWNvbS1KU1cifQ

```
<public>
Promote elevated lines properties to stable: `line-z-offset` and `line-elevation-reference` (#9756)
</public>
```

cc @mapbox/gl-js
cc @mapbox/maps-ios
cc @mapbox/sdk-platform
cc @mapbox/maps-android

GitOrigin-RevId: 9bfbd8e6d1d80e0787c4015b19537e3379cc0bc1

Author: lasselammi

CHANGELOG.md

@@ -5,6 +5,8 @@ Mapbox welcomes participation and contributions from everyone.
 > **16 KB Page Size Support:** Starting with version 11.7.0 and 10.19.0, **NDK 27 is supported** with dedicated artifacts that include [support for 16 KB page sizes](https://developer.android.com/guide/practices/page-sizes). If your app does not require 16 KB page size support, you can keep using our default artifacts without `-ndk27` suffix. For more information about our NDK support, see https://docs.mapbox.com/android/maps/guides/#ndk-support
 
 # main
+* Introduce new `LineLayer.lineElevationGroundScale` property to scale elevated lines with terrain exaggeration.
+* Promote elevated lines properties to stable: `LineLayer.lineZOffset` and `LineLayer.lineElevationReference`.
 
 # 11.19.0-beta.1 January 28, 2026
 
@@ -13,7 +15,6 @@ Mapbox welcomes participation and contributions from everyone.
 * Introduce new `AnnotationConfig#slotName` property to allow to specify a slot to position annotation layer.
 * Introduce experimental `queryRenderedRasterValues` API for querying the rendered raster values on the map at a specific screen coordinate.
 * Introduce `StyleAttributionsChanged` event for detecting map attributions changes
-* Introduce new `LineLayer.lineElevationGroundScale` property to scale elevated lines with terrain exaggeration.
 * Deprecate `Tilestore.create(path: String)` instead use `TileStore.setRootPath()`.
 
 ## Bug fixes 🐞

extension-compose/api/Release/metalava.txt

@@ -2839,7 +2839,7 @@ package com.mapbox.maps.extension.compose.style.layers.generated {
   public static final class LineCapValue.Companion {
   }
 
-  @androidx.compose.runtime.Immutable @com.mapbox.maps.MapboxExperimental public final class LineElevationReferenceValue {
+  @androidx.compose.runtime.Immutable public final class LineElevationReferenceValue {
     ctor public LineElevationReferenceValue(com.mapbox.bindgen.Value value);
     ctor public LineElevationReferenceValue(com.mapbox.maps.extension.style.expressions.generated.Expression expression);
     method public com.mapbox.bindgen.Value component1();

extension-compose/src/main/java/com/mapbox/maps/extension/compose/annotation/generated/PolylineAnnotationGroupState.kt

@@ -3214,8 +3214,8 @@ package com.mapbox.maps.extension.style.layers.generated {
     method public com.mapbox.maps.extension.style.layers.generated.LineLayer lineElevationGroundScale(com.mapbox.maps.extension.style.expressions.generated.Expression lineElevationGroundScale);
     method public com.mapbox.maps.extension.style.layers.generated.LineLayer lineElevationGroundScaleTransition(com.mapbox.maps.extension.style.types.StyleTransition options);
     method public com.mapbox.maps.extension.style.layers.generated.LineLayer lineElevationGroundScaleTransition(kotlin.jvm.functions.Function1<? super com.mapbox.maps.extension.style.types.StyleTransition.Builder,kotlin.Unit> block);
-    method @com.mapbox.maps.MapboxExperimental public com.mapbox.maps.extension.style.layers.generated.LineLayer lineElevationReference(com.mapbox.maps.extension.style.layers.properties.generated.LineElevationReference lineElevationReference);
-    method @com.mapbox.maps.MapboxExperimental public com.mapbox.maps.extension.style.layers.generated.LineLayer lineElevationReference(com.mapbox.maps.extension.style.expressions.generated.Expression lineElevationReference);
+    method public com.mapbox.maps.extension.style.layers.generated.LineLayer lineElevationReference(com.mapbox.maps.extension.style.layers.properties.generated.LineElevationReference lineElevationReference);
+    method public com.mapbox.maps.extension.style.layers.generated.LineLayer lineElevationReference(com.mapbox.maps.extension.style.expressions.generated.Expression lineElevationReference);
     method public com.mapbox.maps.extension.style.layers.generated.LineLayer lineEmissiveStrength(double lineEmissiveStrength);
     method public com.mapbox.maps.extension.style.layers.generated.LineLayer lineEmissiveStrength(com.mapbox.maps.extension.style.expressions.generated.Expression lineEmissiveStrength);
     method public com.mapbox.maps.extension.style.layers.generated.LineLayer lineEmissiveStrengthTransition(com.mapbox.maps.extension.style.types.StyleTransition options);
@@ -3274,8 +3274,8 @@ package com.mapbox.maps.extension.style.layers.generated {
     method public com.mapbox.maps.extension.style.layers.generated.LineLayer lineWidthTransition(kotlin.jvm.functions.Function1<? super com.mapbox.maps.extension.style.types.StyleTransition.Builder,kotlin.Unit> block);
     method @com.mapbox.maps.MapboxExperimental public com.mapbox.maps.extension.style.layers.generated.LineLayer lineWidthUnit(com.mapbox.maps.extension.style.layers.properties.generated.LineWidthUnit lineWidthUnit);
     method @com.mapbox.maps.MapboxExperimental public com.mapbox.maps.extension.style.layers.generated.LineLayer lineWidthUnit(com.mapbox.maps.extension.style.expressions.generated.Expression lineWidthUnit);
-    method @com.mapbox.maps.MapboxExperimental public com.mapbox.maps.extension.style.layers.generated.LineLayer lineZOffset(double lineZOffset);
-    method @com.mapbox.maps.MapboxExperimental public com.mapbox.maps.extension.style.layers.generated.LineLayer lineZOffset(com.mapbox.maps.extension.style.expressions.generated.Expression lineZOffset);
+    method public com.mapbox.maps.extension.style.layers.generated.LineLayer lineZOffset(double lineZOffset);
+    method public com.mapbox.maps.extension.style.layers.generated.LineLayer lineZOffset(com.mapbox.maps.extension.style.expressions.generated.Expression lineZOffset);
     method public com.mapbox.maps.extension.style.layers.generated.LineLayer maxZoom(double maxZoom);
     method public com.mapbox.maps.extension.style.layers.generated.LineLayer minZoom(double minZoom);
     method public com.mapbox.maps.extension.style.layers.generated.LineLayer slot(String slot);
@@ -3617,8 +3617,8 @@ package com.mapbox.maps.extension.style.layers.generated {
     method public com.mapbox.maps.extension.style.layers.generated.LineLayer lineElevationGroundScale(com.mapbox.maps.extension.style.expressions.generated.Expression lineElevationGroundScale);
     method public com.mapbox.maps.extension.style.layers.generated.LineLayer lineElevationGroundScaleTransition(com.mapbox.maps.extension.style.types.StyleTransition options);
     method public com.mapbox.maps.extension.style.layers.generated.LineLayer lineElevationGroundScaleTransition(kotlin.jvm.functions.Function1<? super com.mapbox.maps.extension.style.types.StyleTransition.Builder,kotlin.Unit> block);
-    method @com.mapbox.maps.MapboxExperimental public com.mapbox.maps.extension.style.layers.generated.LineLayer lineElevationReference(com.mapbox.maps.extension.style.layers.properties.generated.LineElevationReference lineElevationReference = com.mapbox.maps.extension.style.layers.properties.generated.LineElevationReference.NONE);
-    method @com.mapbox.maps.MapboxExperimental public com.mapbox.maps.extension.style.layers.generated.LineLayer lineElevationReference(com.mapbox.maps.extension.style.expressions.generated.Expression lineElevationReference);
+    method public com.mapbox.maps.extension.style.layers.generated.LineLayer lineElevationReference(com.mapbox.maps.extension.style.layers.properties.generated.LineElevationReference lineElevationReference = com.mapbox.maps.extension.style.layers.properties.generated.LineElevationReference.NONE);
+    method public com.mapbox.maps.extension.style.layers.generated.LineLayer lineElevationReference(com.mapbox.maps.extension.style.expressions.generated.Expression lineElevationReference);
     method public com.mapbox.maps.extension.style.layers.generated.LineLayer lineEmissiveStrength(double lineEmissiveStrength = 0.0);
     method public com.mapbox.maps.extension.style.layers.generated.LineLayer lineEmissiveStrength(com.mapbox.maps.extension.style.expressions.generated.Expression lineEmissiveStrength);
     method public com.mapbox.maps.extension.style.layers.generated.LineLayer lineEmissiveStrengthTransition(com.mapbox.maps.extension.style.types.StyleTransition options);
@@ -3677,8 +3677,8 @@ package com.mapbox.maps.extension.style.layers.generated {
     method public com.mapbox.maps.extension.style.layers.generated.LineLayer lineWidthTransition(kotlin.jvm.functions.Function1<? super com.mapbox.maps.extension.style.types.StyleTransition.Builder,kotlin.Unit> block);
     method @com.mapbox.maps.MapboxExperimental public com.mapbox.maps.extension.style.layers.generated.LineLayer lineWidthUnit(com.mapbox.maps.extension.style.layers.properties.generated.LineWidthUnit lineWidthUnit = com.mapbox.maps.extension.style.layers.properties.generated.LineWidthUnit.PIXELS);
     method @com.mapbox.maps.MapboxExperimental public com.mapbox.maps.extension.style.layers.generated.LineLayer lineWidthUnit(com.mapbox.maps.extension.style.expressions.generated.Expression lineWidthUnit);
-    method @com.mapbox.maps.MapboxExperimental public com.mapbox.maps.extension.style.layers.generated.LineLayer lineZOffset(double lineZOffset = 0.0);
-    method @com.mapbox.maps.MapboxExperimental public com.mapbox.maps.extension.style.layers.generated.LineLayer lineZOffset(com.mapbox.maps.extension.style.expressions.generated.Expression lineZOffset);
+    method public com.mapbox.maps.extension.style.layers.generated.LineLayer lineZOffset(double lineZOffset = 0.0);
+    method public com.mapbox.maps.extension.style.layers.generated.LineLayer lineZOffset(com.mapbox.maps.extension.style.expressions.generated.Expression lineZOffset);
     method public com.mapbox.maps.extension.style.layers.generated.LineLayer maxZoom(double maxZoom);
     method public com.mapbox.maps.extension.style.layers.generated.LineLayer minZoom(double minZoom);
     method public com.mapbox.maps.extension.style.layers.generated.LineLayer slot(String slot);
@@ -6564,7 +6564,7 @@ package com.mapbox.maps.extension.style.layers.properties.generated {
     method public com.mapbox.maps.extension.style.layers.properties.generated.LineCap valueOf(String value);
   }
 
-  @com.mapbox.maps.MapboxExperimental public final class LineElevationReference {
+  public final class LineElevationReference {
     method public String getValue();
     method public static com.mapbox.maps.extension.style.layers.properties.generated.LineElevationReference valueOf(String value);
     property public String value;