From 7d3bacc69df0ba1151836c8da40bace5dfc5f037 Mon Sep 17 00:00:00 2001
From: Polesznyák Márk <contact@pml68.dev>
Date: Sun, 19 Oct 2025 12:17:01 +0200
Subject: feat: add selectable `Rich` widget with an example

---
 src/lib.rs | 44 ++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 42 insertions(+), 2 deletions(-)

(limited to 'src/lib.rs')

diff --git a/src/lib.rs b/src/lib.rs
index d103b63..ce5a124 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -3,10 +3,11 @@
 //! [`Paragraph`]: https://docs.iced.rs/iced_graphics/text/paragraph/struct.Paragraph.html
 
 pub mod selection;
-
 pub mod text;
 
 use iced_widget::core;
+use iced_widget::graphics::text::Paragraph;
+#[doc(no_inline)]
 pub use text::Text;
 
 /// Creates a new [`Text`] widget with the provided content.
@@ -17,9 +18,22 @@ macro_rules! text {
     };
 }
 
+/// Creates some [`Rich`] text with the given spans.
+///
+/// [`Rich`]: crate::text::Rich
+#[macro_export]
+macro_rules! rich_text {
+    () => (
+        $crate::text::Rich::new()
+    );
+    ($($x:expr),+ $(,)?) => (
+        $crate::text::Rich::from_iter([$($crate::text::Span::from($x)),+])
+    );
+}
+
 /// Creates a new [`Text`] widget with the provided content.
 pub fn text<'a, Theme, Renderer>(
-    text: impl core::text::IntoFragment<'a>,
+    text: impl text::IntoFragment<'a>,
 ) -> Text<'a, Theme, Renderer>
 where
     Theme: text::Catalog + 'a,
@@ -27,3 +41,29 @@ where
 {
     Text::new(text)
 }
+
+/// Creates some [`Rich`] text with the given spans.
+///
+/// [`Rich`]: crate::text::Rich
+pub fn rich_text<'a, Link, Message, Theme, Renderer>(
+    spans: impl AsRef<[text::Span<'a, Link, core::Font>]> + 'a,
+) -> text::Rich<'a, Link, Message, Theme, Renderer>
+where
+    Link: Clone + 'static,
+    Theme: text::Catalog + 'a,
+    Renderer: core::text::Renderer<Paragraph = Paragraph, Font = core::Font>,
+{
+    text::Rich::with_spans(spans)
+}
+
+/// Creates a new [`Span`] of text with the provided content.
+///
+/// A [`Span`] is a fragment of some [`Rich`] text.
+///
+/// [`Rich`]: crate::text::Rich
+/// [`Span`]: crate::text::Span
+pub fn span<'a, Link>(
+    text: impl text::IntoFragment<'a>,
+) -> text::Span<'a, Link, core::Font> {
+    text::Span::new(text)
+}
-- 
cgit v1.2.3