feat: Add support for styled Title

Author: Muscraft

src/level.rs

@@ -62,7 +62,7 @@ impl<'a> Level<'a> {
     /// <div class="warning">
     ///
     /// Text passed to this function is considered "untrusted input", as such
-    /// all text is passed through a normalization function. Pre-styled text is
+    /// all text is passed through a normalization function. Styled text is
     /// not allowed to be passed to this function.
     ///
     /// </div>
@@ -80,14 +80,37 @@ impl<'a> Level<'a> {
             level: self,
             id: None,
             text: text.into(),
+            allows_styling: false,
+        }
+    }
+
+    /// Creates a [`Title`] that is allowed to be styled, for more info see the
+    /// warning below.
+    ///
+    /// See [`Group::with_title`][crate::Group::with_title]
+    ///
+    /// <div class="warning">
+    ///
+    /// Text passed to this function is allowed to be styled, as such all
+    /// text is considered "trusted input" and has no normalizations applied to
+    /// it. [`normalize_untrusted_str`](crate::normalize_untrusted_str) can be
+    /// used to normalize untrusted text before it is passed to this function.
+    ///
+    /// </div>
+    pub fn secondary_title(self, text: impl Into<Cow<'a, str>>) -> Title<'a> {
+        Title {
+            level: self,
+            id: None,
+            text: text.into(),
+            allows_styling: true,
         }
     }
 
     /// A text [`Element`][crate::Element] in a [`Group`][crate::Group]
     ///
     /// <div class="warning">
     ///
-    /// Text passed to this function is allowed to be pre-styled, as such all
+    /// Text passed to this function is allowed to be styled, as such all
     /// text is considered "trusted input" and has no normalizations applied to
     /// it. [`normalize_untrusted_str`](crate::normalize_untrusted_str) can be
     /// used to normalize untrusted text before it is passed to this function.

src/renderer/mod.rs

@@ -596,7 +596,7 @@ impl Renderer {
             label_width
         });
 
-        let (title_str, style) = if title.is_pre_styled() {
+        let (title_str, style) = if title.allows_styling() {
             (title.text().to_owned(), ElementStyle::NoStyle)
         } else {
             (normalize_whitespace(title.text()), title_element_style)
@@ -2609,7 +2609,7 @@ trait MessageOrTitle {
     fn level(&self) -> &Level<'_>;
     fn id(&self) -> Option<&Id<'_>>;
     fn text(&self) -> &str;
-    fn is_pre_styled(&self) -> bool;
+    fn allows_styling(&self) -> bool;
 }
 
 impl MessageOrTitle for Title<'_> {
@@ -2622,8 +2622,8 @@ impl MessageOrTitle for Title<'_> {
     fn text(&self) -> &str {
         self.text.as_ref()
     }
-    fn is_pre_styled(&self) -> bool {
-        false
+    fn allows_styling(&self) -> bool {
+        self.allows_styling
     }
 }
 
@@ -2637,7 +2637,7 @@ impl MessageOrTitle for Message<'_> {
     fn text(&self) -> &str {
         self.text.as_ref()
     }
-    fn is_pre_styled(&self) -> bool {
+    fn allows_styling(&self) -> bool {
         true
     }
 }

src/snippet.rs

@@ -138,6 +138,7 @@ pub struct Title<'a> {
     pub(crate) level: Level<'a>,
     pub(crate) id: Option<Id<'a>>,
     pub(crate) text: Cow<'a, str>,
+    pub(crate) allows_styling: bool,
 }
 
 impl<'a> Title<'a> {

tests/color/styled_title.rs

@@ -30,7 +30,7 @@ use c::cnb_runtime;
                 .annotation(AnnotationKind::Primary.span(65..86).label(label_1))
                 .annotation(AnnotationKind::Context.span(53..64).label(label_2)),
         ),
-        Group::with_title(Level::HELP.primary_title(title_2)).element(
+        Group::with_title(Level::HELP.secondary_title(title_2)).element(
             Snippet::source(source)
                 .path("src/main.rs")
                 .annotation(AnnotationKind::Primary.span(4..5).label(label_3))