chore(deps): update comrak to 0.35

crates/rari-md/Cargo.toml

@@ -14,4 +14,4 @@ rari-types.workspace = true
 itertools.workspace = true
 base64.workspace = true
 
-comrak = { version = "0.33", default-features = false }
+comrak = { version = "0.35", default-features = false }

crates/rari-md/README.md

@@ -0,0 +1,9 @@
+To update `html.rs` when upgrading comrak:
+
+```sh
+export FROM=from-version
+export TO=to-version
+curl -o /tmp/html.rs.${FROM} https://github.com/kivikakk/comrak/raw/refs/tags/v${FROM}/src/html.rs
+curl -o /tmp/html.rs.${TO} https://github.com/kivikakk/comrak/raw/refs/tags/v${TO}/src/html.rs
+git merge-file src/html.rs /tmp/html.rs.${FROM} /tmp/html.rs.${TO}
+```

crates/rari-md/src/html.rs

@@ -23,7 +23,7 @@ use crate::anchor;
 use crate::character_set::character_set;
 use crate::ctype::isspace;
 use crate::ext::{Flag, DELIM_START};
-use crate::node_card::{is_callout, NoteCard};
+use crate::node_card::{alert_type_css_class, alert_type_default_title, is_callout, NoteCard};
 
 /// Formats an AST as HTML, modified by the given options.
 pub fn format_document<'a>(
@@ -889,7 +889,7 @@ where
                 }
             }
             NodeValue::Link(ref nl) => {
-                // Unreliable sourcepos.                let parent_node = node.parent();
+                // Unreliable sourcepos.
                 let parent_node = node.parent();
 
                 if !self.options.parse.relaxed_autolinks
@@ -1197,6 +1197,31 @@ where
                 // Nowhere to put sourcepos.
                 self.output.write_all(net.as_bytes())?;
             }
+            NodeValue::Alert(ref alert) => {
+                if entering {
+                    self.cr()?;
+                    self.output.write_all(b"<div class=\"markdown-alert ")?;
+                    self.output
+                        .write_all(alert_type_css_class(&alert.alert_type).as_bytes())?;
+                    self.output.write_all(b"\"")?;
+                    self.render_sourcepos(node)?;
+                    self.output.write_all(b">\n")?;
+                    self.output
+                        .write_all(b"<p class=\"markdown-alert-title\">")?;
+                    match alert.title {
+                        Some(ref title) => self.escape(title.as_bytes())?,
+                        None => {
+                            self.output.write_all(
+                                alert_type_default_title(&alert.alert_type).as_bytes(),
+                            )?;
+                        }
+                    }
+                    self.output.write_all(b"</p>\n")?;
+                } else {
+                    self.cr()?;
+                    self.output.write_all(b"</div>\n")?;
+                }
+            }
         }
         Ok((false, Flag::None))
     }

crates/rari-md/src/node_card.rs

@@ -1,4 +1,4 @@
-use comrak::nodes::{AstNode, NodeValue};
+use comrak::nodes::{AlertType, AstNode, NodeValue};
 use rari_types::locale::Locale;
 
 pub enum NoteCard {
@@ -107,3 +107,25 @@ pub(crate) fn is_callout<'a>(block_quote: &'a AstNode<'a>, locale: Locale) -> Op
     }
     None
 }
+
+/// Returns the default title for an alert type
+pub fn alert_type_default_title(alert_type: &AlertType) -> String {
+    match *alert_type {
+        AlertType::Note => String::from("Note"),
+        AlertType::Tip => String::from("Tip"),
+        AlertType::Important => String::from("Important"),
+        AlertType::Warning => String::from("Warning"),
+        AlertType::Caution => String::from("Caution"),
+    }
+}
+
+/// Returns the CSS class to use for an alert type
+pub fn alert_type_css_class(alert_type: &AlertType) -> String {
+    match *alert_type {
+        AlertType::Note => String::from("markdown-alert-note"),
+        AlertType::Tip => String::from("markdown-alert-tip"),
+        AlertType::Important => String::from("markdown-alert-important"),
+        AlertType::Warning => String::from("markdown-alert-warning"),
+        AlertType::Caution => String::from("markdown-alert-caution"),
+    }
+}