Add pathtext recipe for text along a path

CHANGELOG.md

@@ -2,6 +2,7 @@
 
 ## Unreleased
 
+- Added `pathtext` recipe for placing text along a path, plus `Ann.Styles.WithText` to layer path text onto any existing `annotation` style [#5596](https://github.com/MakieOrg/Makie.jl/pull/5596).
 - Fixed shared precompile file path not being relocatable by using `RelocatableFolders.@path` [#5597](https://github.com/MakieOrg/Makie.jl/pull/5597)
 - Added possibility to gather legend entries from multiple axes [#5551](https://github.com/MakieOrg/Makie.jl/pull/5551)
 - Added complete inverse transformation support to `register_projected_positions!` with `apply_inverse_transform`, `apply_inverse_transform_func`, `apply_inverse_float32convert`, and `apply_inverse_model` kwargs. These enable correct projection from non-data spaces back to data space. Includes early-exit optimization to skip redundant transform/inverse pairs when `input_space === output_space`. [#5485](https://github.com/MakieOrg/Makie.jl/pull/5485)

Makie/src/Makie.jl

@@ -417,6 +417,7 @@ include("makielayout/MakieLayout.jl")
 include("figureplotting.jl")
 include("basic_recipes/series.jl")
 include("basic_recipes/text.jl")
+include("basic_recipes/pathtext.jl")
 include("basic_recipes/raincloud.jl")
 include("deprecated.jl")
 

Makie/src/basic_recipes/annotation.jl

@@ -39,6 +39,7 @@ baremodule Ann # bare for cleanest tab-completion behavior
         using Base
 
         using ..Arrows: Arrows
+        using ...Makie: Makie
 
         struct Line end
 
@@ -47,6 +48,32 @@ baremodule Ann # bare for cleanest tab-completion behavior
             tail = nothing
         end
 
+        """
+            Ann.Styles.WithText(style; text, ...)
+
+        Wraps another annotation `style` and additionally draws `text` along the
+        connection path using `pathtext`. The inner `style` is rendered first,
+        then the text is layered on top so it follows the same curve.
+        """
+        struct WithText
+            style::Any
+            text::Any
+            fontsize::Float64
+            align::Any
+            offset::Float64
+            color::Any
+        end
+        function WithText(
+                style;
+                text = "",
+                fontsize = 12.0,
+                align = (:center, :bottom),
+                offset = 4.0,
+                color = Makie.automatic,
+            )
+            return WithText(style, text, Float64(fontsize), align, Float64(offset), color)
+        end
+
     end
 end
 
@@ -1023,6 +1050,20 @@ function annotation_style_plotspecs(::Ann.Styles.Line, path::BezierPath, p1, p2;
     ]
 end
 
+function annotation_style_plotspecs(s::Ann.Styles.WithText, path::BezierPath, p1, p2; color, linewidth)
+    specs = annotation_style_plotspecs(s.style, path, p1, p2; color, linewidth)
+    textcolor = s.color === automatic ? color : s.color
+    push!(
+        specs,
+        PlotSpec(
+            :PathText, path;
+            text = s.text, fontsize = s.fontsize, align = s.align,
+            offset = s.offset, color = textcolor, space = :pixel,
+        ),
+    )
+    return specs
+end
+
 _auto(x::Automatic, default) = default
 _auto(x, default) = x
 
@@ -1087,6 +1128,23 @@ function attribute_examples(::Type{Annotation})
                 fig
                 """
             ),
+            Example(
+                code = raw"""
+                fig = Figure()
+                ax = Axis(fig[1, 1])
+                A, B = Point2f(1, 2), Point2f(5, 5)
+                scatter!(ax, [A, B], markersize = 10, color = :black)
+                text!(ax, [A, B], text = ["A", "B"],
+                    align = (:right, :top), offset = (-6, -4))
+                annotation!(ax, [A], [B];
+                    text = [""],
+                    path = Ann.Paths.Arc(height = 0.4),
+                    style = Ann.Styles.WithText(Ann.Styles.LineArrow();
+                        text = "from A to B", fontsize = 14),
+                    color = :steelblue, labelspace = :data, shrink = (5.0, 5.0))
+                fig
+                """
+            ),
         ],
         :path => [
             Example(