Add inheritColor()

Author: MKoroteev-HORIS

future_changes.md

@@ -8,6 +8,9 @@ GeoTools [v 33.2](https://github.com/geotools/geotools/releases/tag/33.2)
 - Geometries:
   - `geomTextRepel()` and `geomLabelRepel()` [[#1092](https://github.com/JetBrains/lets-plot/issues/1092)].  
    See: [example notebook](https://nbviewer.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.11.0/ggrepel.ipynb).
+- Layer Labels (Annotations):
+
+  - New `inheritColor()` option in annotations configuration (see example notebooks above)
 
 - Plot Layout:
 

plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/annotations/AnnotationOptions.kt

@@ -11,8 +11,24 @@ typealias AnnotationOptions = layerLabels
 
 
 /**
- *  Configures annotations (for pie chart).
- *  Defines the content and format for displaying the value.
+* Configure annotations for geometry layers.
+ *
+ * Annotations are currently supported for bar, pie, and crossbar geometry
+ * layers. This class provides methods to customize the appearance and
+ * content of text labels displayed on these geometries.
+ *
+ * Notes
+ * -----
+ * By default, annotation text color is automatically selected for optimal
+ * contrast: white text appears on darker filled geometries, and black text
+ * appears on lighter filled geometries.
+ *
+ * The text color can be manually specified using:
+ * ``theme(labelText=elementText(color=...))``
+ *
+ * Alternatively, the ``inheritColor()`` method can be used to override both
+ * automatic and manual color settings, making the annotation text use the
+ * geometry's ``color`` aesthetic instead.
  *
  * ## Examples
  *
@@ -121,12 +137,17 @@ class layerLabels(vararg variables: String) {
         return setOption(ANNOTATION_SIZE, value)
     }
 
+    fun inheritColor(): layerLabels {
+        return setOption(USE_LAYER_COLOR, true)
+    }
+
     private companion object {
         private const val VARIABLES = Option.LinesSpec.VARIABLES
         private const val FORMATS = Option.LinesSpec.FORMATS
         private const val FIELD = Option.LinesSpec.Format.FIELD
         private const val FORMAT = Option.LinesSpec.Format.FORMAT
         private const val LINES = Option.LinesSpec.LINES
         private const val ANNOTATION_SIZE = Option.AnnotationSpec.ANNOTATION_SIZE
+        private const val USE_LAYER_COLOR = Option.AnnotationSpec.USE_LAYER_COLOR
     }
 }