build(deps): Bump comrak from 0.24.1 to 0.25.0 (#570)

Bumps [comrak](https://github.com/kivikakk/comrak) from 0.24.1 to
0.25.0.
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/kivikakk/comrak/releases">comrak's
releases</a>.</em></p>
<blockquote>
<h2>v0.25.0</h2>
<ul>
<li>Discord-flavored Markdown by <a
href="https://github.com/liamwhite"><code>@​liamwhite</code></a> in <a
href="https://redirect.github.com/kivikakk/comrak/pull/421">kivikakk/comrak#421</a>
<ul>
<li>Three new extensions and two render options are added:
<ul>
<li><code>extension.underline</code> adds support for
<code>__underlined__</code> text.</li>
<li><code>extension.spoiler</code> adds support for
<code>||spoiler||</code> text.</li>
<li><code>extension.greentext</code> adds support for image board-style
<code>&gt;greentext</code>, which isn't transformed into a
blockquote.</li>
<li><code>render.ignore_setext</code> disables parsing setext-style
headings.</li>
<li><code>render.ignore_empty_links</code> causes links with no text
(like <code>[](https://github.com/kivikakk/comrak/blob/HEAD/xyz)</code>)
to remain in the text as-is.</li>
</ul>
</li>
</ul>
</li>
<li>nodes: add From impls for AstNode. by <a
href="https://github.com/kivikakk"><code>@​kivikakk</code></a> in <a
href="https://redirect.github.com/kivikakk/comrak/pull/424">kivikakk/comrak#424</a>
<ul>
<li>Back by popular demand: <code>AstNode::from(NodeValue)</code>.</li>
<li>Also added is <code>AstNode::from(Ast)</code>, if you have
sourcepos.</li>
</ul>
</li>
<li>AST validation by <a
href="https://github.com/yannham"><code>@​yannham</code></a> in <a
href="https://redirect.github.com/kivikakk/comrak/pull/425">kivikakk/comrak#425</a>
<ul>
<li>The AST is validated when formatting a document as CommonMark in
debug builds.</li>
</ul>
</li>
<li>Address autolink edge cases. by <a
href="https://github.com/kivikakk"><code>@​kivikakk</code></a> in <a
href="https://redirect.github.com/kivikakk/comrak/pull/426">kivikakk/comrak#426</a>
<ul>
<li>Autolinks had many edge cases where output differed from upstream
<code>cmark-gfm</code>. These have been fixed by following upstream's
parser design closely.</li>
</ul>
</li>
<li>shortcodes: capture all known aliases. by <a
href="https://github.com/kivikakk"><code>@​kivikakk</code></a> in <a
href="https://redirect.github.com/kivikakk/comrak/pull/427">kivikakk/comrak#427</a>
<ul>
<li>We didn't parse shortcodes containing numbers or <code>+</code>. We
do now.</li>
</ul>
</li>
<li>Support both upstream CommonMark and GFM's differences in the base
spec. by <a
href="https://github.com/kivikakk"><code>@​kivikakk</code></a> in <a
href="https://redirect.github.com/kivikakk/comrak/pull/428">kivikakk/comrak#428</a>
<ul>
<li>GFM modifies even base CommonMark output somewhat. We now support
and validate against both.</li>
</ul>
</li>
<li>cm: count ol items from start of each list. by <a
href="https://github.com/kivikakk"><code>@​kivikakk</code></a> in <a
href="https://redirect.github.com/kivikakk/comrak/pull/429">kivikakk/comrak#429</a>
<ul>
<li>Ordered list item numbers are normalised on formatting back to
CommonMark.</li>
</ul>
</li>
<li>arena_tree: panic if iterator invalidation causes trouble. by <a
href="https://github.com/kivikakk"><code>@​kivikakk</code></a> in <a
href="https://redirect.github.com/kivikakk/comrak/pull/437">kivikakk/comrak#437</a>
<ul>
<li><code>arena_tree</code> would silently stop iteration when trying to
proceed from a child that had lost its parent. It now panics instead, as
the old behaviour is incorrect and impossible to notice.</li>
</ul>
</li>
<li>broken reflink callback updates &amp; big cleanup. by <a
href="https://github.com/kivikakk"><code>@​kivikakk</code></a> in <a
href="https://redirect.github.com/kivikakk/comrak/pull/438">kivikakk/comrak#438</a>
<ul>
<li>The broken reference link callback has been moved into
<code>ParseOptions</code> (which now takes a lifetime, meaning
<code>Options</code> does too).</li>
<li>The callback now takes a struct containing both the normalised
reference, and the original text, and the return value has changed from
a 2-tuple to a struct for clarity.</li>
<li><code>parse_document_with_broken_link_callback</code> has been
marked deprecated.</li>
</ul>
</li>
<li>Inline sourcepos fixes. by <a
href="https://github.com/kivikakk"><code>@​kivikakk</code></a> in <a
href="https://redirect.github.com/kivikakk/comrak/pull/439">kivikakk/comrak#439</a>
<ul>
<li>Inline sourcepos was provided on a best-effort basis, but there are
multiple correctness issues which can't be fixed without significant
work.</li>
<li>Inline sourcepos is no longer reported in HTML output. It remains in
the AST and in XML output, but it is not reliable. See the PR for
details.</li>
<li>Link sourcepos is slightly better than it was when it spans multiple
lines.</li>
</ul>
</li>
</ul>
<h2>New Contributors</h2>
<ul>
<li><a href="https://github.com/liamwhite"><code>@​liamwhite</code></a>
made their first contribution in <a
href="https://redirect.github.com/kivikakk/comrak/pull/421">kivikakk/comrak#421</a></li>
<li><a href="https://github.com/yannham"><code>@​yannham</code></a> made
their first contribution in <a
href="https://redirect.github.com/kivikakk/comrak/pull/425">kivikakk/comrak#425</a></li>
</ul>
<p>Diff: <a
href="https://github.com/kivikakk/comrak/compare/v0.24.1...v0.25.0">https://github.com/kivikakk/comrak/compare/v0.24.1...v0.25.0</a></p>
</blockquote>
</details>
<details>
<summary>Changelog</summary>
<p><em>Sourced from <a
href="https://github.com/kivikakk/comrak/blob/main/changelog.txt">comrak's
changelog</a>.</em></p>
<blockquote>
<h1>[v0.25.0] - 12-07-2024</h1>
<ul>
<li>Discord-flavored Markdown by <a
href="https://github.com/liamwhite"><code>@​liamwhite</code></a> in <a
href="https://redirect.github.com/kivikakk/comrak/pull/421">kivikakk/comrak#421</a>
<ul>
<li>Three new extensions and two render options are added:
<ul>
<li><code>extension.underline</code> adds support for
<code>__underlined__</code> text.</li>
<li><code>extension.spoiler</code> adds support for
<code>||spoiler||</code> text.</li>
<li><code>extension.greentext</code> adds support for image board-style
<code>&gt;greentext</code>,
which isn't transformed into a blockquote.</li>
<li><code>render.ignore_setext</code> disables parsing setext-style
headings.</li>
<li><code>render.ignore_empty_links</code> causes links with no text
(like <code>[](https://github.com/kivikakk/comrak/blob/main/xyz)</code>)
to
remain in the text as-is.</li>
</ul>
</li>
</ul>
</li>
<li>nodes: add From impls for AstNode. by <a
href="https://github.com/kivikakk"><code>@​kivikakk</code></a> in <a
href="https://redirect.github.com/kivikakk/comrak/pull/424">kivikakk/comrak#424</a>
<ul>
<li>Back by popular demand: <code>AstNode::from(NodeValue)</code>.</li>
<li>Also added is <code>AstNode::from(Ast)</code>, if you have
sourcepos.</li>
</ul>
</li>
<li>AST validation by <a
href="https://github.com/yannham"><code>@​yannham</code></a> in <a
href="https://redirect.github.com/kivikakk/comrak/pull/425">kivikakk/comrak#425</a>
<ul>
<li>The AST is validated when formatting a document as CommonMark in
debug builds.</li>
</ul>
</li>
<li>Address autolink edge cases. by <a
href="https://github.com/kivikakk"><code>@​kivikakk</code></a> in <a
href="https://redirect.github.com/kivikakk/comrak/pull/426">kivikakk/comrak#426</a>
<ul>
<li>Autolinks had many edge cases where output differed from upstream
<code>cmark-gfm</code>. These have been fixed by following upstream's
parser design
closely.</li>
</ul>
</li>
<li>shortcodes: capture all known aliases. by <a
href="https://github.com/kivikakk"><code>@​kivikakk</code></a> in <a
href="https://redirect.github.com/kivikakk/comrak/pull/427">kivikakk/comrak#427</a>
<ul>
<li>We didn't parse shortcodes containing numbers or <code>+</code>. We
do now.</li>
</ul>
</li>
<li>Support both upstream CommonMark and GFM's differences in the base
spec. by <a
href="https://github.com/kivikakk"><code>@​kivikakk</code></a> in <a
href="https://redirect.github.com/kivikakk/comrak/pull/428">kivikakk/comrak#428</a>
<ul>
<li>GFM modifies even base CommonMark output somewhat. We now support
and
validate against both.</li>
</ul>
</li>
<li>cm: count ol items from start of each list. by <a
href="https://github.com/kivikakk"><code>@​kivikakk</code></a> in <a
href="https://redirect.github.com/kivikakk/comrak/pull/429">kivikakk/comrak#429</a>
<ul>
<li>Ordered list item numbers are normalised on formatting back to
CommonMark.</li>
</ul>
</li>
<li>arena_tree: panic if iterator invalidation causes trouble. by <a
href="https://github.com/kivikakk"><code>@​kivikakk</code></a> in <a
href="https://redirect.github.com/kivikakk/comrak/pull/437">kivikakk/comrak#437</a>
<ul>
<li><code>arena_tree</code> would silently stop iteration when trying to
proceed from a
child that had lost its parent. It now panics instead, as the old
behaviour
is incorrect and impossible to notice.</li>
</ul>
</li>
<li>broken reflink callback updates &amp; big cleanup. by <a
href="https://github.com/kivikakk"><code>@​kivikakk</code></a> in <a
href="https://redirect.github.com/kivikakk/comrak/pull/438">kivikakk/comrak#438</a>
<ul>
<li>The broken reference link callback has been moved into
<code>ParseOptions</code> (which
now takes a lifetime, meaning <code>Options</code> does too).</li>
<li>The callback now takes a struct containing both the normalised
reference,
and the original text, and the return value has changed from a 2-tuple
to a
struct for clarity.</li>
<li><code>parse_document_with_broken_link_callback</code> has been
marked deprecated.</li>
</ul>
</li>
<li>Inline sourcepos fixes. by <a
href="https://github.com/kivikakk"><code>@​kivikakk</code></a> in <a
href="https://redirect.github.com/kivikakk/comrak/pull/439">kivikakk/comrak#439</a>
<ul>
<li>Inline sourcepos was provided on a best-effort basis, but there are
multiple
correctness issues which can't be fixed without significant work.</li>
<li>Inline sourcepos is no longer reported in HTML output. It remains in
the AST
and in XML output, but it is not reliable. See the PR for details.</li>
<li>Link sourcepos is slightly better than it was when it spans multiple
lines.</li>
</ul>
</li>
</ul>
<h2>New Contributors</h2>
<ul>
<li><a href="https://github.com/liamwhite"><code>@​liamwhite</code></a>
made their first contribution in <a
href="https://redirect.github.com/kivikakk/comrak/pull/421">kivikakk/comrak#421</a></li>
<li><a href="https://github.com/yannham"><code>@​yannham</code></a> made
their first contribution in <a
href="https://redirect.github.com/kivikakk/comrak/pull/425">kivikakk/comrak#425</a></li>
</ul>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/kivikakk/comrak/commit/ae113bfcb2d4a82b9c10c9a74d019ae79f5679aa"><code>ae113bf</code></a>
Merge pull request <a
href="https://redirect.github.com/kivikakk/comrak/issues/440">#440</a>
from kivikakk/release/v0.25.0</li>
<li><a
href="https://github.com/kivikakk/comrak/commit/83e90b22cd495cec082658ae323ac9c256f48967"><code>83e90b2</code></a>
changelog.txt: elaborate on 0.25.0, and clean up.</li>
<li><a
href="https://github.com/kivikakk/comrak/commit/17c02a2e00069e0b58f729bf6b63cb396635a7f7"><code>17c02a2</code></a>
[skip test] update changelog</li>
<li><a
href="https://github.com/kivikakk/comrak/commit/5515ad29b114573aa6d7937985465afa4743578f"><code>5515ad2</code></a>
Cargo.toml: v0.25.0.</li>
<li><a
href="https://github.com/kivikakk/comrak/commit/a38b4e3c1f40bf92f330a9064dadf4b73d6810f9"><code>a38b4e3</code></a>
Merge pull request <a
href="https://redirect.github.com/kivikakk/comrak/issues/439">#439</a>
from kivikakk/inline-sourcepos</li>
<li><a
href="https://github.com/kivikakk/comrak/commit/983180b957e712b5f5280450a12fe4d66aaee38f"><code>983180b</code></a>
parser: document sourcepos reliability.</li>
<li><a
href="https://github.com/kivikakk/comrak/commit/cc17182c99da32c284ebe6aeb4db54b9710c185a"><code>cc17182</code></a>
html: don't report sourcepos on inlines.</li>
<li><a
href="https://github.com/kivikakk/comrak/commit/21d97febda7b4c90bd4272c6971fb6a19bef600e"><code>21d97fe</code></a>
tests: ignore some failures.</li>
<li><a
href="https://github.com/kivikakk/comrak/commit/69ebedd45d169f23280263dc18db4635b203accd"><code>69ebedd</code></a>
tests: another case which misses.</li>
<li><a
href="https://github.com/kivikakk/comrak/commit/c27194906ea3f05b9e071b20f47f0d7093a2b812"><code>c271949</code></a>
tests: note this <em>works</em> and must remain.</li>
<li>Additional commits viewable in <a
href="https://github.com/kivikakk/comrak/compare/v0.24.1...v0.25.0">compare
view</a></li>
</ul>
</details>
<br />


[![Dependabot compatibility
score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=comrak&package-manager=cargo&previous-version=0.24.1&new-version=0.25.0)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores)

Dependabot will resolve any conflicts with this PR as long as you don't
alter it yourself. You can also trigger a rebase manually by commenting
`@dependabot rebase`.

[//]: # (dependabot-automerge-start)
[//]: # (dependabot-automerge-end)

---

<details>
<summary>Dependabot commands and options</summary>
<br />

You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits
that have been made to it
- `@dependabot merge` will merge this PR after your CI passes on it
- `@dependabot squash and merge` will squash and merge this PR after
your CI passes on it
- `@dependabot cancel merge` will cancel a previously requested merge
and block automerging
- `@dependabot reopen` will reopen this PR if it is closed
- `@dependabot close` will close this PR and stop Dependabot recreating
it. You can achieve the same result by closing it manually
- `@dependabot show <dependency name> ignore conditions` will show all
of the ignore conditions of the specified dependency
- `@dependabot ignore this major version` will close this PR and stop
Dependabot creating any more for this major version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this minor version` will close this PR and stop
Dependabot creating any more for this minor version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this dependency` will close this PR and stop
Dependabot creating any more for this dependency (unless you reopen the
PR or upgrade to it yourself)


</details>

Signed-off-by: dependabot[bot] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

macro/Cargo.toml

@@ -13,7 +13,7 @@ keywords = ["mlir", "llvm"]
 proc-macro = true
 
 [dependencies]
-comrak = { version = "0.24.1", default-features = false }
+comrak = { version = "0.25.0", default-features = false }
 convert_case = "0.6.0"
 once_cell = "1.19.0"
 proc-macro2 = "1"