Add axisTextSpacing parameters to theme()

Author: MKoroteev-HORIS

demo/jvm-batik/src/main/kotlin/frontendContextDemo/scripts/Spoke.kt

@@ -6,7 +6,6 @@ import org.jetbrains.letsPlot.geom.extras.arrow
 import org.jetbrains.letsPlot.geom.geomSpoke
 import org.jetbrains.letsPlot.letsPlot
 import org.jetbrains.letsPlot.scale.scaleColorGradient
-import org.jetbrains.letsPlot.themes.elementText
 import org.jetbrains.letsPlot.themes.theme
 import org.jetbrains.letsPlot.themes.themeMinimal
 import org.jetbrains.letsPlot.tooltips.layerTooltips
@@ -78,7 +77,7 @@ object Spoke {
                         scaleColorGradient(low = "#3288bd", high = "#d53e4f", guide = "none") +
                         coordFixed(xlim = ab, ylim = ab) +
                         themeMinimal() +
-                        theme(axisText = elementText(margin = 10), axisTitle = "blank")
+                        theme(axisTextSpacing = 10.0, plotMargin = 6.0, axisTitle = "blank")
 
                 p.show()
             }

future_changes.md

@@ -9,6 +9,11 @@ GeoTools [v 33.2](https://github.com/geotools/geotools/releases/tag/33.2)
   - `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).
 
+- Plot Layout:
+
+    - New `axisTextSpacing`, `axisTextSpacingX`, and `axisTextSpacingY` parameters in `theme()` to control spacing between axis ticks and labels.
+    - See new [plot layout diagram](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25b/plot_layout_scheme.ipynb) notebook showing various layout options and their effects on plot appearance.
+
 
 ### Changed
 

plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/themes/theme.kt

@@ -82,6 +82,10 @@ import org.jetbrains.letsPlot.intern.filterNonNullValues
  * @param axisTicksLengthX Length of tick marks.
  * @param axisTicksLengthY Length of tick marks.
  *
+ * @param axisTextSpacing Spacing between the axis label text and its tick mark.
+ * @param axisTextSpacingX Spacing between the axis label text and its tick mark.
+ * @param axisTextSpacingY Spacing between the axis label text and its tick mark.
+ *
  * @param axisLine Lines along axes.
  * @param axisLineX Lines along axes.
  * @param axisLineY Lines along axes.
@@ -225,6 +229,10 @@ class theme(
     axisTicksLengthX: Number? = null,
     axisTicksLengthY: Number? = null,
 
+    axisTextSpacing: Number? = null,
+    axisTextSpacingX: Number? = null,
+    axisTextSpacingY: Number? = null,
+
     axisLine: Any? = null,
     axisLineX: Any? = null,
     axisLineY: Any? = null,
@@ -332,6 +340,10 @@ class theme(
         Option.Theme.AXIS_TICKS_LENGTH_X to axisTicksLengthX,
         Option.Theme.AXIS_TICKS_LENGTH_Y to axisTicksLengthY,
 
+        Option.Theme.AXIS_TEXT_SPACING to axisTextSpacing,
+        Option.Theme.AXIS_TEXT_SPACING_X to axisTextSpacingX,
+        Option.Theme.AXIS_TEXT_SPACING_Y to axisTextSpacingY,
+
         Option.Theme.AXIS_LINE to axisLine,
         Option.Theme.AXIS_LINE_X to axisLineX,
         Option.Theme.AXIS_LINE_Y to axisLineY,