From 01b60a7df8d0373c205ef7be564e28d210e809b3 Mon Sep 17 00:00:00 2001
From: Khang Nguyen Duy <40488299+iceghost@users.noreply.github.com>
Date: Sun, 25 Jun 2023 12:15:28 +0700
Subject: [PATCH 01/67] docs: fix broken links (#275)

the links point to structs, whereas it should be traits
---
 README.md  | 4 ++--
 README.tpl | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index ff25b3a..61fcf50 100644
--- a/README.md
+++ b/README.md
@@ -648,7 +648,7 @@ under the Apache License. Some code is taken from
 [`MietteHandler`]: https://docs.rs/miette/latest/miette/struct.MietteHandler.html
 [`MietteDiagnostic`]: https://docs.rs/miette/latest/miette/struct.MietteDiagnostic.html
 [`Report`]: https://docs.rs/miette/latest/miette/struct.Report.html
-[`ReportHandler`]: https://docs.rs/miette/latest/miette/struct.ReportHandler.html
+[`ReportHandler`]: https://docs.rs/miette/latest/miette/trait.ReportHandler.html
 [`Result`]: https://docs.rs/miette/latest/miette/type.Result.html
-[`SourceCode`]: https://docs.rs/miette/latest/miette/struct.SourceCode.html
+[`SourceCode`]: https://docs.rs/miette/latest/miette/trait.SourceCode.html
 [`SourceSpan`]: https://docs.rs/miette/latest/miette/struct.SourceSpan.html
diff --git a/README.tpl b/README.tpl
index d598eb8..f1126f1 100644
--- a/README.tpl
+++ b/README.tpl
@@ -12,7 +12,7 @@
 [`MietteHandler`]: https://docs.rs/miette/latest/miette/struct.MietteHandler.html
 [`MietteDiagnostic`]: https://docs.rs/miette/latest/miette/struct.MietteDiagnostic.html
 [`Report`]: https://docs.rs/miette/latest/miette/struct.Report.html
-[`ReportHandler`]: https://docs.rs/miette/latest/miette/struct.ReportHandler.html
+[`ReportHandler`]: https://docs.rs/miette/latest/miette/trait.ReportHandler.html
 [`Result`]: https://docs.rs/miette/latest/miette/type.Result.html
-[`SourceCode`]: https://docs.rs/miette/latest/miette/struct.SourceCode.html
+[`SourceCode`]: https://docs.rs/miette/latest/miette/trait.SourceCode.html
 [`SourceSpan`]: https://docs.rs/miette/latest/miette/struct.SourceSpan.html

From 89806755a4d89e2dc15bfd1d94f6b758df205571 Mon Sep 17 00:00:00 2001
From: 0x009922 <a.marcius26@gmail.com>
Date: Thu, 29 Jun 2023 08:42:12 +0700
Subject: [PATCH 02/67] docs: a little cleaning in README (#274)

---
 README.md | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 61fcf50..8375876 100644
--- a/README.md
+++ b/README.md
@@ -96,7 +96,7 @@ You can derive a `Diagnostic` from any `std::error::Error` type.
 
 `thiserror` is a great way to define them, and plays nicely with `miette`!
 */
-use miette::{Diagnostic, SourceSpan};
+use miette::{Diagnostic, NamedSource, Result, SourceSpan};
 use thiserror::Error;
 
 #[derive(Error, Debug, Diagnostic)]
@@ -123,12 +123,10 @@ Use this `Result` type (or its expanded version) as the return type
 throughout your app (but NOT your libraries! Those should always return
 concrete types!).
 */
-use miette::{NamedSource, Result};
 fn this_fails() -> Result<()> {
     // You can use plain strings as a `Source`, or anything that implements
     // the one-method `Source` trait.
     let src = "source\n  text\n    here".to_string();
-    let len = src.len();
 
     Err(MyBad {
         src: NamedSource::new("bad_file.rs", src),

From 2e3e5c9d15e234495369e9b47d032644dd5664ad Mon Sep 17 00:00:00 2001
From: Bennett Hardwick <me@bennetthardwick.com>
Date: Thu, 29 Jun 2023 11:58:35 +1000
Subject: [PATCH 03/67] feat(protocol): add StdError impl for Box<dyn
 Diagnostic + Send + Sync> (#273)

---
 src/protocol.rs                   | 24 ++++++++---
 tests/test_derive_source_chain.rs | 69 +++++++++++++++++++++++++++++++
 2 files changed, 87 insertions(+), 6 deletions(-)
 create mode 100644 tests/test_derive_source_chain.rs

diff --git a/src/protocol.rs b/src/protocol.rs
index 7531db1..f516984 100644
--- a/src/protocol.rs
+++ b/src/protocol.rs
@@ -69,16 +69,28 @@ pub trait Diagnostic: std::error::Error {
     }
 }
 
-impl std::error::Error for Box<dyn Diagnostic> {
-    fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
-        (**self).source()
-    }
+macro_rules! box_impls {
+    ($($box_type:ty),*) => {
+        $(
+            impl std::error::Error for $box_type {
+                fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
+                    (**self).source()
+                }
 
-    fn cause(&self) -> Option<&dyn std::error::Error> {
-        self.source()
+                fn cause(&self) -> Option<&dyn std::error::Error> {
+                    self.source()
+                }
+            }
+        )*
     }
 }
 
+box_impls! {
+    Box<dyn Diagnostic>,
+    Box<dyn Diagnostic + Send>,
+    Box<dyn Diagnostic + Send + Sync>
+}
+
 impl<T: Diagnostic + Send + Sync + 'static> From<T>
     for Box<dyn Diagnostic + Send + Sync + 'static>
 {
diff --git a/tests/test_derive_source_chain.rs b/tests/test_derive_source_chain.rs
new file mode 100644
index 0000000..fb7ddb2
--- /dev/null
+++ b/tests/test_derive_source_chain.rs
@@ -0,0 +1,69 @@
+use std::sync::Arc;
+
+use miette::{miette, Diagnostic};
+use thiserror::Error;
+
+#[test]
+fn test_source() {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("Bar")]
+    struct Bar;
+
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("Foo")]
+    struct Foo {
+        #[source]
+        bar: Bar,
+    }
+
+    let e = miette!(Foo { bar: Bar });
+    let mut chain = e.chain();
+
+    assert_eq!("Foo", chain.next().unwrap().to_string());
+    assert_eq!("Bar", chain.next().unwrap().to_string());
+    assert!(chain.next().is_none());
+}
+
+#[test]
+fn test_source_boxed() {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("Bar")]
+    struct Bar;
+
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("Foo")]
+    struct Foo {
+        #[source]
+        bar: Box<dyn Diagnostic + Send + Sync>,
+    }
+
+    let error = miette!(Foo { bar: Box::new(Bar) });
+
+    let mut chain = error.chain();
+
+    assert_eq!("Foo", chain.next().unwrap().to_string());
+    assert_eq!("Bar", chain.next().unwrap().to_string());
+    assert!(chain.next().is_none());
+}
+
+#[test]
+fn test_source_arc() {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("Bar")]
+    struct Bar;
+
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("Foo")]
+    struct Foo {
+        #[source]
+        bar: Arc<dyn Diagnostic + Send + Sync>,
+    }
+
+    let error = miette!(Foo { bar: Arc::new(Bar) });
+
+    let mut chain = error.chain();
+
+    assert_eq!("Foo", chain.next().unwrap().to_string());
+    assert_eq!("Bar", chain.next().unwrap().to_string());
+    assert!(chain.next().is_none());
+}

From c3d4db2618c06743c6db615a372a347e0bd4ed1a Mon Sep 17 00:00:00 2001
From: Bruce Mitchener <bruce.mitchener@gmail.com>
Date: Sat, 8 Jul 2023 07:16:53 +0700
Subject: [PATCH 04/67] docs: Fix broken links from macro docs. (#278)

---
 src/eyreish/macros.rs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/eyreish/macros.rs b/src/eyreish/macros.rs
index 938ac32..e13309f 100644
--- a/src/eyreish/macros.rs
+++ b/src/eyreish/macros.rs
@@ -222,6 +222,9 @@ macro_rules! ensure {
 /// ## `anyhow`/`eyre` Users
 ///
 /// You can just replace `use`s of the `anyhow!`/`eyre!` macros with `miette!`.
+///
+/// [`diagnostic!`]: crate::diagnostic!
+/// [`Report`]: crate::Report
 #[macro_export]
 macro_rules! miette {
     ($($key:ident = $value:expr,)* $fmt:literal $($arg:tt)*) => {
@@ -282,6 +285,8 @@ macro_rules! miette {
 )]
 /// assert_eq!(diag.message, "1 + 2 = 3");
 /// ```
+///
+/// [`MietteDiagnostic`]: crate::MietteDiagnostic
 #[macro_export]
 macro_rules! diagnostic {
     ($fmt:literal $($arg:tt)*) => {{

From bfacb6329f0063b5dc5a8c0b4344743cf3fa183a Mon Sep 17 00:00:00 2001
From: Gavrilikhin Daniil <gavrilikhin.daniil@gmail.com>
Date: Sun, 16 Jul 2023 04:46:54 +0300
Subject: [PATCH 05/67] doc: document `#[diagnostic(transparent)]` (#266)

---
 README.md  | 75 ++++++++++++++++++++++++++++++++----------------------
 src/lib.rs | 14 +++++++++-
 2 files changed, 57 insertions(+), 32 deletions(-)

diff --git a/README.md b/README.md
index 8375876..a60ef11 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@
 You run miette? You run her code like the software? Oh. Oh! Error code for
 coder! Error code for One Thousand Lines!
 
-## About
+### About
 
 `miette` is a diagnostic library for Rust. It includes a series of
 traits/protocols that allow you to hook into its error reporting facilities,
@@ -32,7 +32,7 @@ output like in the screenshots above.** You should only do this in your
 toplevel crate, as the fancy feature pulls in a number of dependencies that
 libraries and such might not want.
 
-## Table of Contents <!-- omit in toc -->
+### Table of Contents <!-- omit in toc -->
 
 - [About](#about)
 - [Features](#features)
@@ -51,7 +51,7 @@ libraries and such might not want.
 - [Acknowledgements](#acknowledgements)
 - [License](#license)
 
-## Features
+### Features
 
 - Generic [`Diagnostic`] protocol, compatible (and dependent on)
   [`std::error::Error`].
@@ -76,7 +76,7 @@ the following features:
 - Cause chain printing
 - Turns diagnostic codes into links in [supported terminals](https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda).
 
-## Installing
+### Installing
 
 ```sh
 $ cargo add miette
@@ -88,7 +88,7 @@ If you want to use the fancy printer in all these screenshots:
 $ cargo add miette --features fancy
 ```
 
-## Example
+### Example
 
 ```rust
 /*
@@ -168,9 +168,9 @@ diagnostic help: Change int or string to be the right types and try again.
 diagnostic code: nu::parser::unsupported_operation
 For more details, see https://docs.rs/nu-parser/0.1.0/nu-parser/enum.ParseError.html#variant.UnsupportedOperation">
 
-## Using
+### Using
 
-### ... in libraries
+#### ... in libraries
 
 `miette` is _fully compatible_ with library usage. Consumers who don't know
 about, or don't want, `miette` features can safely use its error types as
@@ -185,7 +185,7 @@ the trait directly, just like with `std::error::Error`.
 
 ```rust
 // lib/error.rs
-use miette::Diagnostic;
+use miette::{Diagnostic, SourceSpan};
 use thiserror::Error;
 
 #[derive(Error, Diagnostic, Debug)]
@@ -197,6 +197,18 @@ pub enum MyLibError {
     #[error("Oops it blew up")]
     #[diagnostic(code(my_lib::bad_code))]
     BadThingHappened,
+
+    #[error(transparent)]
+    // Use `#[diagnostic(transparent)]` to wrap another [`Diagnostic`]. You won't see labels otherwise
+    #[diagnostic(transparent)]
+    AnotherError(#[from] AnotherError),
+}
+
+#[derive(Error, Diagnostic, Debug)]
+#[error("another error")]
+pub struct AnotherError {
+   #[label("here")]
+   pub at: SourceSpan
 }
 ```
 
@@ -204,7 +216,7 @@ Then, return this error type from all your fallible public APIs. It's a best
 practice to wrap any "external" error types in your error `enum` instead of
 using something like [`Report`] in a library.
 
-### ... in application code
+#### ... in application code
 
 Application code tends to work a little differently than libraries. You
 don't always need or care to define dedicated error wrappers for errors
@@ -246,8 +258,7 @@ pub fn some_tool() -> Result<Version> {
 }
 ```
 
-To construct your own simple adhoc error use the [`miette!`] macro:
-
+To construct your own simple adhoc error use the [miette!] macro:
 ```rust
 // my_app/lib/my_internal_file.rs
 use miette::{miette, IntoDiagnostic, Result, WrapErr};
@@ -260,8 +271,9 @@ pub fn some_tool() -> Result<Version> {
         .map_err(|_| miette!("Invalid version {}", version))?)
 }
 ```
+There are also similar [bail!] and [ensure!] macros.
 
-### ... in `main()`
+#### ... in `main()`
 
 `main()` is just like any other part of your application-internal code. Use
 `Result` as your return value, and it will pretty-print your diagnostics
@@ -291,7 +303,7 @@ enabled:
 miette = { version = "X.Y.Z", features = ["fancy"] }
 ```
 
-### ... diagnostic code URLs
+#### ... diagnostic code URLs
 
 `miette` supports providing a URL for individual diagnostics. This URL will
 be displayed as an actual link in supported terminals, like so:
@@ -344,7 +356,7 @@ use thiserror::Error;
 struct MyErr;
 ```
 
-### ... snippets
+#### ... snippets
 
 Along with its general error handling and reporting features, `miette` also
 includes facilities for adding error spans/annotations/labels to your
@@ -392,7 +404,7 @@ pub struct MyErrorType {
 }
 ```
 
-#### ... help text
+##### ... help text
 `miette` provides two facilities for supplying help text for your errors:
 
 The first is the `#[help()]` format attribute that applies to structs or
@@ -428,7 +440,7 @@ let err = Foo {
 };
 ```
 
-### ... multiple related errors
+#### ... multiple related errors
 
 `miette` supports collecting multiple errors into a single diagnostic, and
 printing them all together nicely.
@@ -448,7 +460,7 @@ struct MyError {
 }
 ```
 
-### ... delayed source code
+#### ... delayed source code
 
 Sometimes it makes sense to add source code to the error message later.
 One option is to use [`with_source_code()`](Report::with_source_code)
@@ -531,7 +543,7 @@ fn main() -> miette::Result<()> {
 }
 ```
 
-### ... Diagnostic-based error sources.
+#### ... Diagnostic-based error sources.
 
 When one uses the `#[source]` attribute on a field, that usually comes
 from `thiserror`, and implements a method for
@@ -564,7 +576,7 @@ struct MyError {
 struct OtherError;
 ```
 
-### ... handler options
+#### ... handler options
 
 [`MietteHandler`] is the default handler, and is very customizable. In
 most cases, you can simply use [`MietteHandlerOpts`] to tweak its behavior
@@ -583,12 +595,13 @@ miette::set_hook(Box::new(|_| {
             .build(),
     )
 }))
+
 ```
 
 See the docs for [`MietteHandlerOpts`] for more details on what you can
 customize!
 
-### ... dynamic diagnostics
+#### ... dynamic diagnostics
 
 If you...
 - ...don't know all the possible errors upfront
@@ -597,6 +610,7 @@ then you may want to use [`miette!`], [`diagnostic!`] macros or
 [`MietteDiagnostic`] directly to create diagnostic on the fly.
 
 ```rust
+
 let source = "2 + 2 * 2 = 8".to_string();
 let report = miette!(
   labels = vec[
@@ -608,26 +622,25 @@ let report = miette!(
 println!("{:?}", report)
 ```
 
-## Acknowledgements
+### Acknowledgements
 
 `miette` was not developed in a void. It owes enormous credit to various
 other projects and their authors:
 
-- [`anyhow`](http://crates.io/crates/anyhow) and
-  [`color-eyre`](https://crates.io/crates/color-eyre): these two
-  enormously influential error handling libraries have pushed forward the
-  experience of application-level error handling and error reporting.
-  `miette`'s `Report` type is an attempt at a very very rough version of
-  their `Report` types.
-- [`thiserror`](https://crates.io/crates/thiserror) for setting the
-  standard for library-level error definitions, and for being the
-  inspiration behind `miette`'s derive macro.
+- [`anyhow`](http://crates.io/crates/anyhow) and [`color-eyre`](https://crates.io/crates/color-eyre):
+  these two enormously influential error handling libraries have pushed
+  forward the experience of application-level error handling and error
+  reporting. `miette`'s `Report` type is an attempt at a very very rough
+  version of their `Report` types.
+- [`thiserror`](https://crates.io/crates/thiserror) for setting the standard
+  for library-level error definitions, and for being the inspiration behind
+  `miette`'s derive macro.
 - `rustc` and [@estebank](https://github.com/estebank) for their
   state-of-the-art work in compiler diagnostics.
 - [`ariadne`](https://crates.io/crates/ariadne) for pushing forward how
   _pretty_ these diagnostics can really look!
 
-## License
+### License
 
 `miette` is released to the Rust community under the [Apache license
 2.0](./LICENSE).
diff --git a/src/lib.rs b/src/lib.rs
index cc113ce..20589ef 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -186,7 +186,7 @@
 //!
 //! ```rust
 //! // lib/error.rs
-//! use miette::Diagnostic;
+//! use miette::{Diagnostic, SourceSpan};
 //! use thiserror::Error;
 //!
 //! #[derive(Error, Diagnostic, Debug)]
@@ -198,6 +198,18 @@
 //!     #[error("Oops it blew up")]
 //!     #[diagnostic(code(my_lib::bad_code))]
 //!     BadThingHappened,
+//!
+//!     #[error(transparent)]
+//!     // Use `#[diagnostic(transparent)]` to wrap another [`Diagnostic`]. You won't see labels otherwise
+//!     #[diagnostic(transparent)]
+//!     AnotherError(#[from] AnotherError),
+//! }
+//!
+//! #[derive(Error, Diagnostic, Debug)]
+//! #[error("another error")]
+//! pub struct AnotherError {
+//!    #[label("here")]
+//!    pub at: SourceSpan
 //! }
 //! ```
 //!

From 10c3b7f809ec7f8885c4f63fc9e36d3e419c339e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kat=20March=C3=A1n?= <kzm@zkat.tech>
Date: Sat, 15 Jul 2023 18:48:00 -0700
Subject: [PATCH 06/67] docs: update readme again

---
 README.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index a60ef11..7aabe99 100644
--- a/README.md
+++ b/README.md
@@ -96,7 +96,7 @@ You can derive a `Diagnostic` from any `std::error::Error` type.
 
 `thiserror` is a great way to define them, and plays nicely with `miette`!
 */
-use miette::{Diagnostic, NamedSource, Result, SourceSpan};
+use miette::{Diagnostic, SourceSpan};
 use thiserror::Error;
 
 #[derive(Error, Debug, Diagnostic)]
@@ -123,10 +123,12 @@ Use this `Result` type (or its expanded version) as the return type
 throughout your app (but NOT your libraries! Those should always return
 concrete types!).
 */
+use miette::{NamedSource, Result};
 fn this_fails() -> Result<()> {
     // You can use plain strings as a `Source`, or anything that implements
     // the one-method `Source` trait.
     let src = "source\n  text\n    here".to_string();
+    let len = src.len();
 
     Err(MyBad {
         src: NamedSource::new("bad_file.rs", src),

From f8d13825015317828dc268071b8f9bd50579e4ca Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kat=20March=C3=A1n?= <kzm@zkat.tech>
Date: Sat, 15 Jul 2023 18:48:59 -0700
Subject: [PATCH 07/67] docs: update changelog

---
 CHANGELOG.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0b842de..955c27d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,12 @@
 # `miette` Release Changelog
 
+<a name="5.10.0"></a>
+## 5.10.0 (2023-07-16)
+
+### Features
+
+* **protocol:** add StdError impl for Box<dyn Diagnostic + Send + Sync> (#273) ([2e3e5c9d](https://github.com/zkat/miette/commit/2e3e5c9d15e234495369e9b47d032644dd5664ad))
+
 <a name="5.9.0"></a>
 ## 5.9.0 (2023-05-18)
 

From f4d056e1ffeb9a0bf36e2a6501365bd7e00db22d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kat=20March=C3=A1n?= <kzm@zkat.tech>
Date: Sat, 15 Jul 2023 18:49:14 -0700
Subject: [PATCH 08/67] chore: Release

---
 Cargo.toml               | 4 ++--
 miette-derive/Cargo.toml | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/Cargo.toml b/Cargo.toml
index 160556f..dd6e584 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "miette"
-version = "5.9.0"
+version = "5.10.0"
 authors = ["Kat Marchán <kzm@zkat.tech>"]
 description = "Fancy diagnostic reporting library and protocol for us mere mortals who aren't compiler hackers."
 categories = ["rust-patterns"]
@@ -14,7 +14,7 @@ exclude = ["images/", "tests/", "miette-derive/"]
 
 [dependencies]
 thiserror = "1.0.40"
-miette-derive = { path = "miette-derive", version = "=5.9.0" }
+miette-derive = { path = "miette-derive", version = "=5.10.0" }
 once_cell = "1.8.0"
 unicode-width = "0.1.9"
 
diff --git a/miette-derive/Cargo.toml b/miette-derive/Cargo.toml
index 461a328..becdc17 100644
--- a/miette-derive/Cargo.toml
+++ b/miette-derive/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "miette-derive"
-version = "5.9.0"
+version = "5.10.0"
 authors = ["Kat Marchán <kzm@zkat.tech>"]
 edition = "2018"
 license = "Apache-2.0"

From a9c2bae9dc095e530c5ff4cccb6a08b05084afc8 Mon Sep 17 00:00:00 2001
From: Bruce Mitchener <bruce.mitchener@gmail.com>
Date: Mon, 18 Sep 2023 23:12:56 +0700
Subject: [PATCH 09/67] docs: Improve linking. (#289)

---
 src/eyreish/error.rs  |  8 ++++----
 src/handlers/theme.rs | 11 ++++++-----
 src/protocol.rs       |  2 +-
 3 files changed, 11 insertions(+), 10 deletions(-)

diff --git a/src/eyreish/error.rs b/src/eyreish/error.rs
index 6b0dc34..677f368 100644
--- a/src/eyreish/error.rs
+++ b/src/eyreish/error.rs
@@ -30,9 +30,9 @@ impl Report {
 
     /// Create a new error object from a printable error message.
     ///
-    /// If the argument implements std::error::Error, prefer `Report::new`
+    /// If the argument implements [`std::error::Error`], prefer `Report::new`
     /// instead which preserves the underlying error's cause chain and
-    /// backtrace. If the argument may or may not implement std::error::Error
+    /// backtrace. If the argument may or may not implement [`std::error::Error`]
     /// now or in the future, use `miette!(err)` which handles either way
     /// correctly.
     ///
@@ -206,7 +206,7 @@ impl Report {
     /// Create a new error from an error message to wrap the existing error.
     ///
     /// For attaching a higher level error message to a `Result` as it is
-    /// propagated, the [crate::WrapErr] extension trait may be more
+    /// propagated, the [`WrapErr`](crate::WrapErr) extension trait may be more
     /// convenient than this function.
     ///
     /// The primary reason to use `error.wrap_err(...)` instead of
@@ -233,7 +233,7 @@ impl Report {
         unsafe { Report::construct(error, vtable, handler) }
     }
 
-    /// Compatibility re-export of wrap_err for interop with `anyhow`
+    /// Compatibility re-export of `wrap_err` for interop with `anyhow`
     pub fn context<D>(self, msg: D) -> Self
     where
         D: Display + Send + Sync + 'static,
diff --git a/src/handlers/theme.rs b/src/handlers/theme.rs
index 1f5236a..aa6649e 100644
--- a/src/handlers/theme.rs
+++ b/src/handlers/theme.rs
@@ -55,9 +55,9 @@ impl GraphicalTheme {
 
     /// A "basic" graphical theme that skips colors and unicode characters and
     /// just does monochrome ascii art. If you want a completely non-graphical
-    /// rendering of your `Diagnostic`s, check out
-    /// [crate::NarratableReportHandler], or write your own
-    /// [crate::ReportHandler]!
+    /// rendering of your [`Diagnostic`](crate::Diagnostic)s, check out
+    /// [`NarratableReportHandler`](crate::NarratableReportHandler), or write
+    /// your own [`ReportHandler`](crate::ReportHandler)
     pub fn none() -> Self {
         Self {
             characters: ThemeCharacters::ascii(),
@@ -79,7 +79,8 @@ impl Default for GraphicalTheme {
 }
 
 /**
-Styles for various parts of graphical rendering for the [crate::GraphicalReportHandler].
+Styles for various parts of graphical rendering for the
+[`GraphicalReportHandler`](crate::GraphicalReportHandler).
 */
 #[derive(Debug, Clone)]
 pub struct ThemeStyles {
@@ -159,7 +160,7 @@ impl ThemeStyles {
 // https://github.com/zesterer/ariadne/blob/e3cb394cb56ecda116a0a1caecd385a49e7f6662/src/draw.rs
 
 /// Characters to be used when drawing when using
-/// [crate::GraphicalReportHandler].
+/// [`GraphicalReportHandler`](crate::GraphicalReportHandler).
 #[allow(missing_docs)]
 #[derive(Debug, Clone, Eq, PartialEq)]
 pub struct ThemeCharacters {
diff --git a/src/protocol.rs b/src/protocol.rs
index f516984..36c3539 100644
--- a/src/protocol.rs
+++ b/src/protocol.rs
@@ -232,7 +232,7 @@ whole thing--meaning you should be able to support `SourceCode`s which are
 gigabytes or larger in size.
 */
 pub trait SourceCode: Send + Sync {
-    /// Read the bytes for a specific span from this SourceCode, keeping a
+    /// Read the bytes for a specific span from this `SourceCode`, keeping a
     /// certain number of lines before and after the span as context.
     fn read_span<'a>(
         &'a self,

From cc81382a6070dd226a20e4a39518d88e957ac0e1 Mon Sep 17 00:00:00 2001
From: Bruce Mitchener <bruce.mitchener@gmail.com>
Date: Thu, 21 Sep 2023 00:37:40 +0700
Subject: [PATCH 10/67] fix(misc): Improve ci and fix clippy (#290)

* ci: Update actions, replace actions-rs.

* `actions/checkout` is updated from `v1` to the current `v4`.
* `actions-rs/toolchain` is replaced by `dtolnay/rust-toolchain` as
  the `actions-rs` actions haven't been maintained in a long time.

* clippy: Remove unnecessary call to `into_iter`.

The parameter takes `IntoIterator`, so we don't have to call
`into_iter` at the call site.

* clippy: Remove explicit lifetime that can be elided.

* clippy: tests: Fix useless conversion warnings.

* clippy: tests: Remove call to `format!`.

* Fix minimal-versions build.

Due to changes in the nightly compiler, using a recent nightly
requires proc-macro2 1.0.60 or later:

https://github.com/dtolnay/proc-macro2/issues/356

* ci: Use is-terminal 0.4.7 for MSRV builds.

is-terminal 0.4.8 updated its MSRV to 1.63, so we can't use it
with our MSRV of 1.56. Force usage of the older version which has
an older MSRV.
---
 .github/workflows/ci.yml              | 27 ++++++++-----------
 miette-derive/Cargo.toml              |  2 +-
 src/handlers/graphical.rs             |  4 +--
 src/miette_diagnostic.rs              |  2 +-
 tests/derive.rs                       | 37 ++++++---------------------
 tests/test_diagnostic_source_macro.rs |  2 +-
 tests/test_json.rs                    | 16 ------------
 7 files changed, 24 insertions(+), 66 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 4fafac3..912bfcc 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -10,14 +10,12 @@ jobs:
     name: Check fmt & build docs
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v1
+      - uses: actions/checkout@v4
       - name: Install Rust
-        uses: actions-rs/toolchain@v1
+        uses: dtolnay/rust-toolchain@master
         with:
-          profile: minimal
           toolchain: stable
           components: rustfmt
-          override: true
       - name: rustfmt
         run: cargo fmt --all -- --check
       - name: docs
@@ -32,14 +30,15 @@ jobs:
         os: [ubuntu-latest, macOS-latest, windows-latest]
 
     steps:
-      - uses: actions/checkout@v1
+      - uses: actions/checkout@v4
       - name: Install Rust
-        uses: actions-rs/toolchain@v1
+        uses: dtolnay/rust-toolchain@master
         with:
-          profile: minimal
           toolchain: ${{ matrix.rust }}
           components: clippy
-          override: true
+      - name: Force older version of is-terminal for MSRV builds
+        if: matrix.rust == '1.56.0'
+        run:  cargo update -p is-terminal --precise 0.4.7
       - name: Clippy
         run: cargo clippy --all -- -D warnings
       - name: Run tests
@@ -54,14 +53,12 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v1
+      - uses: actions/checkout@v4
       - name: Install Rust
-        uses: actions-rs/toolchain@v1
+        uses: dtolnay/rust-toolchain@master
         with:
-          profile: minimal
           toolchain: nightly
           components: miri,rust-src
-          override: true
       - name: Run tests with miri
         env:
           MIRIFLAGS: -Zmiri-disable-isolation -Zmiri-strict-provenance
@@ -75,13 +72,11 @@ jobs:
         os: [ubuntu-latest, macOS-latest, windows-latest]
 
     steps:
-      - uses: actions/checkout@v1
+      - uses: actions/checkout@v4
       - name: Install Rust
-        uses: actions-rs/toolchain@v1
+        uses: dtolnay/rust-toolchain@master
         with:
-          profile: minimal
           toolchain: nightly
-          override: true
       - name: Run minimal version build
         run: cargo build -Z minimal-versions --all-features
 
diff --git a/miette-derive/Cargo.toml b/miette-derive/Cargo.toml
index becdc17..b5a7032 100644
--- a/miette-derive/Cargo.toml
+++ b/miette-derive/Cargo.toml
@@ -11,6 +11,6 @@ repository = "https://github.com/zkat/miette"
 proc-macro = true
 
 [dependencies]
-proc-macro2 = "1.0"
+proc-macro2 = "1.0.60"
 quote = "1.0"
 syn = "2.0.11"
diff --git a/src/handlers/graphical.rs b/src/handlers/graphical.rs
index b5dd754..e61f595 100644
--- a/src/handlers/graphical.rs
+++ b/src/handlers/graphical.rs
@@ -382,10 +382,10 @@ impl GraphicalReportHandler {
         Ok(())
     }
 
-    fn render_context<'a>(
+    fn render_context(
         &self,
         f: &mut impl fmt::Write,
-        source: &'a dyn SourceCode,
+        source: &dyn SourceCode,
         context: &LabeledSpan,
         labels: &[LabeledSpan],
     ) -> fmt::Result {
diff --git a/src/miette_diagnostic.rs b/src/miette_diagnostic.rs
index 67b75d0..dc0468e 100644
--- a/src/miette_diagnostic.rs
+++ b/src/miette_diagnostic.rs
@@ -252,7 +252,7 @@ impl MietteDiagnostic {
     /// ```
     pub fn and_labels(mut self, labels: impl IntoIterator<Item = LabeledSpan>) -> Self {
         let mut all_labels = self.labels.unwrap_or_default();
-        all_labels.extend(labels.into_iter());
+        all_labels.extend(labels);
         self.labels = Some(all_labels);
         self
     }
diff --git a/tests/derive.rs b/tests/derive.rs
index 7faae42..dbaf7cb 100644
--- a/tests/derive.rs
+++ b/tests/derive.rs
@@ -189,7 +189,7 @@ fn fmt_help() {
 
     assert_eq!(
         "1 x hello x \"2\"".to_string(),
-        FooStruct("hello".into()).help().unwrap().to_string()
+        FooStruct("hello").help().unwrap().to_string()
     );
 
     #[derive(Debug, Diagnostic, Error)]
@@ -201,12 +201,7 @@ fn fmt_help() {
 
     assert_eq!(
         "1 x hello x \"2\"".to_string(),
-        BarStruct {
-            my_field: "hello".into()
-        }
-        .help()
-        .unwrap()
-        .to_string()
+        BarStruct { my_field: "hello" }.help().unwrap().to_string()
     );
 
     #[derive(Debug, Diagnostic, Error)]
@@ -224,7 +219,7 @@ fn fmt_help() {
 
     assert_eq!(
         "1 x bar x \"2\"".to_string(),
-        FooEnum::X("bar".into()).help().unwrap().to_string()
+        FooEnum::X("bar").help().unwrap().to_string()
     );
 
     assert_eq!(
@@ -250,12 +245,7 @@ fn help_field() {
 
     assert_eq!(
         "x".to_string(),
-        Foo {
-            do_this: Some("x".into())
-        }
-        .help()
-        .unwrap()
-        .to_string()
+        Foo { do_this: Some("x") }.help().unwrap().to_string()
     );
 
     #[derive(Debug, Diagnostic, Error)]
@@ -271,16 +261,11 @@ fn help_field() {
 
     assert_eq!(
         "x".to_string(),
-        Bar::A(Some("x".into())).help().unwrap().to_string()
+        Bar::A(Some("x")).help().unwrap().to_string()
     );
     assert_eq!(
         "x".to_string(),
-        Bar::B {
-            do_this: Some("x".into())
-        }
-        .help()
-        .unwrap()
-        .to_string()
+        Bar::B { do_this: Some("x") }.help().unwrap().to_string()
     );
 
     #[derive(Debug, Diagnostic, Error)]
@@ -288,20 +273,14 @@ fn help_field() {
     #[diagnostic()]
     struct Baz<'a>(#[help] Option<&'a str>);
 
-    assert_eq!(
-        "x".to_string(),
-        Baz(Some("x".into())).help().unwrap().to_string()
-    );
+    assert_eq!("x".to_string(), Baz(Some("x")).help().unwrap().to_string());
 
     #[derive(Debug, Diagnostic, Error)]
     #[error("welp")]
     #[diagnostic()]
     struct Quux<'a>(#[help] &'a str);
 
-    assert_eq!(
-        "x".to_string(),
-        Quux("x".into()).help().unwrap().to_string()
-    );
+    assert_eq!("x".to_string(), Quux("x").help().unwrap().to_string());
 }
 
 #[test]
diff --git a/tests/test_diagnostic_source_macro.rs b/tests/test_diagnostic_source_macro.rs
index 536aedf..df30b2e 100644
--- a/tests/test_diagnostic_source_macro.rs
+++ b/tests/test_diagnostic_source_macro.rs
@@ -79,7 +79,7 @@ fn test_diagnostic_source() {
 fn test_diagnostic_source_pass_extra_info() {
     let diag = TestBoxedError(Box::new(SourceError {
         code: String::from("Hello\nWorld!"),
-        help: format!("Have you tried turning it on and off again?"),
+        help: String::from("Have you tried turning it on and off again?"),
         label: (1, 4),
     }));
     let mut out = String::new();
diff --git a/tests/test_json.rs b/tests/test_json.rs
index 5bd14cb..ae482b8 100644
--- a/tests/test_json.rs
+++ b/tests/test_json.rs
@@ -52,7 +52,6 @@ mod json_report_handler {
             "related": []
         }"#
         .lines()
-        .into_iter()
         .map(|s| s.trim_matches(|c| c == ' ' || c == '\n'))
         .collect();
         assert_eq!(expected, out);
@@ -98,7 +97,6 @@ mod json_report_handler {
             "related": []
         }"#
         .lines()
-        .into_iter()
         .map(|s| s.trim_matches(|c| c == ' ' || c == '\n'))
         .collect();
         assert_eq!(expected, out);
@@ -144,7 +142,6 @@ mod json_report_handler {
             "related": []
         }"#
         .lines()
-        .into_iter()
         .map(|s| s.trim_matches(|c| c == ' ' || c == '\n'))
         .collect();
         assert_eq!(expected, out);
@@ -190,7 +187,6 @@ mod json_report_handler {
             "related": []
         }"#
         .lines()
-        .into_iter()
         .map(|s| s.trim_matches(|c| c == ' ' || c == '\n'))
         .collect();
         assert_eq!(expected, out);
@@ -235,7 +231,6 @@ mod json_report_handler {
             "related": []
         }"#
         .lines()
-        .into_iter()
         .map(|s| s.trim_matches(|c| c == ' ' || c == '\n'))
         .collect();
         assert_eq!(expected, out);
@@ -281,7 +276,6 @@ mod json_report_handler {
             "related": []
         }"#
         .lines()
-        .into_iter()
         .map(|s| s.trim_matches(|c| c == ' ' || c == '\n'))
         .collect();
         assert_eq!(expected, out);
@@ -347,7 +341,6 @@ mod json_report_handler {
             "related": []
         }"#
         .lines()
-        .into_iter()
         .map(|s| s.trim_matches(|c| c == ' ' || c == '\n'))
         .collect();
         assert_eq!(expected, out);
@@ -393,7 +386,6 @@ mod json_report_handler {
             "related": []
         }"#
         .lines()
-        .into_iter()
         .map(|s| s.trim_matches(|c| c == ' ' || c == '\n'))
         .collect();
         assert_eq!(expected, out);
@@ -456,7 +448,6 @@ mod json_report_handler {
             "related": []
         }"#
         .lines()
-        .into_iter()
         .map(|s| s.trim_matches(|c| c == ' ' || c == '\n'))
         .collect();
         assert_eq!(expected, out);
@@ -532,7 +523,6 @@ mod json_report_handler {
             "related": []
         }"#
         .lines()
-        .into_iter()
         .map(|s| s.trim_matches(|c| c == ' ' || c == '\n'))
         .collect();
         assert_eq!(expected, out);
@@ -588,7 +578,6 @@ mod json_report_handler {
             "related": []
         }"#
         .lines()
-        .into_iter()
         .map(|s| s.trim_matches(|c| c == ' ' || c == '\n'))
         .collect();
         assert_eq!(expected, out);
@@ -644,7 +633,6 @@ mod json_report_handler {
             "related": []
         }"#
         .lines()
-        .into_iter()
         .map(|s| s.trim_matches(|c| c == ' ' || c == '\n'))
         .collect();
         assert_eq!(expected, out);
@@ -700,7 +688,6 @@ mod json_report_handler {
             "related": []
         }"#
         .lines()
-        .into_iter()
         .map(|s| s.trim_matches(|c| c == ' ' || c == '\n'))
         .collect();
         assert_eq!(expected, out);
@@ -728,7 +715,6 @@ mod json_report_handler {
             "related": []
         }"#
         .lines()
-        .into_iter()
         .map(|s| s.trim_matches(|c| c == ' ' || c == '\n'))
         .collect();
         assert_eq!(expected, out);
@@ -822,7 +808,6 @@ mod json_report_handler {
             }]
         }"#
         .lines()
-        .into_iter()
         .map(|s| s.trim_matches(|c| c == ' ' || c == '\n'))
         .collect();
         assert_eq!(expected, out);
@@ -920,7 +905,6 @@ mod json_report_handler {
             }]
         }"#
         .lines()
-        .into_iter()
         .map(|s| s.trim_matches(|c| c == ' ' || c == '\n'))
         .collect();
         assert_eq!(expected, out);

From db0b7e403a5ae52ae360991b6508490d8c579886 Mon Sep 17 00:00:00 2001
From: Will Crichton <wcrichto@cs.stanford.edu>
Date: Wed, 20 Sep 2023 15:36:33 -0700
Subject: [PATCH 11/67] feat(labels): Add support for primary label in
 specifying line/col information (#291)

---
 miette-derive/src/label.rs            | 79 +++++++++++++++++++++------
 src/handlers/graphical.rs             | 27 +++++++--
 src/miette_diagnostic.rs              | 12 ++--
 src/protocol.rs                       | 32 +++++++++--
 tests/graphical.rs                    | 73 ++++++++++++++++++-------
 tests/test_diagnostic_source_macro.rs |  2 +-
 6 files changed, 174 insertions(+), 51 deletions(-)

diff --git a/miette-derive/src/label.rs b/miette-derive/src/label.rs
index e0bc70a..dd5ec69 100644
--- a/miette-derive/src/label.rs
+++ b/miette-derive/src/label.rs
@@ -20,10 +20,12 @@ struct Label {
     label: Option<Display>,
     ty: syn::Type,
     span: syn::Member,
+    primary: bool,
 }
 
 struct LabelAttr {
     label: Option<Display>,
+    primary: bool,
 }
 
 impl Parse for LabelAttr {
@@ -40,10 +42,22 @@ impl Parse for LabelAttr {
             }
         });
         let la = input.lookahead1();
-        let label = if la.peek(syn::token::Paren) {
-            // #[label("{}", x)]
+        let (primary, label) = if la.peek(syn::token::Paren) {
+            // #[label(primary?, "{}", x)]
             let content;
             parenthesized!(content in input);
+
+            let primary = if content.peek(syn::Ident) {
+                let ident: syn::Ident = content.parse()?;
+                if ident != "primary" {
+                    return Err(syn::Error::new(input.span(), "Invalid argument to label() attribute. The argument must be a literal string or the keyword `primary`."));
+                }
+                let _ = content.parse::<Token![,]>();
+                true
+            } else {
+                false
+            };
+
             if content.peek(syn::LitStr) {
                 let fmt = content.parse()?;
                 let args = if content.is_empty() {
@@ -56,22 +70,27 @@ impl Parse for LabelAttr {
                     args,
                     has_bonus_display: false,
                 };
-                Some(display)
+                (primary, Some(display))
+            } else if !primary {
+                return Err(syn::Error::new(input.span(), "Invalid argument to label() attribute. The argument must be a literal string or the keyword `primary`."));
             } else {
-                return Err(syn::Error::new(input.span(), "Invalid argument to label() attribute. The first argument must be a literal string."));
+                (primary, None)
             }
         } else if la.peek(Token![=]) {
             // #[label = "blabla"]
             input.parse::<Token![=]>()?;
-            Some(Display {
-                fmt: input.parse()?,
-                args: TokenStream::new(),
-                has_bonus_display: false,
-            })
+            (
+                false,
+                Some(Display {
+                    fmt: input.parse()?,
+                    args: TokenStream::new(),
+                    has_bonus_display: false,
+                }),
+            )
         } else {
-            None
+            (false, None)
         };
-        Ok(LabelAttr { label })
+        Ok(LabelAttr { label, primary })
     }
 }
 
@@ -100,12 +119,21 @@ impl Labels {
                         })
                     };
                     use quote::ToTokens;
-                    let LabelAttr { label } =
+                    let LabelAttr { label, primary } =
                         syn::parse2::<LabelAttr>(attr.meta.to_token_stream())?;
+
+                    if primary && labels.iter().any(|l: &Label| l.primary) {
+                        return Err(syn::Error::new(
+                            field.span(),
+                            "Cannot have more than one primary label.",
+                        ));
+                    }
+
                     labels.push(Label {
                         label,
                         span,
                         ty: field.ty.clone(),
+                        primary,
                     });
                 }
             }
@@ -120,13 +148,23 @@ impl Labels {
     pub(crate) fn gen_struct(&self, fields: &syn::Fields) -> Option<TokenStream> {
         let (display_pat, display_members) = display_pat_members(fields);
         let labels = self.0.iter().map(|highlight| {
-            let Label { span, label, ty } = highlight;
+            let Label {
+                span,
+                label,
+                ty,
+                primary,
+            } = highlight;
             let var = quote! { __miette_internal_var };
+            let ctor = if *primary {
+                quote! { miette::LabeledSpan::new_primary_with_span }
+            } else {
+                quote! { miette::LabeledSpan::new_with_span }
+            };
             if let Some(display) = label {
                 let (fmt, args) = display.expand_shorthand_cloned(&display_members);
                 quote! {
                     miette::macro_helpers::OptionalWrapper::<#ty>::new().to_option(&self.#span)
-                    .map(|#var| miette::LabeledSpan::new_with_span(
+                    .map(|#var| #ctor(
                         std::option::Option::Some(format!(#fmt #args)),
                         #var.clone(),
                     ))
@@ -134,7 +172,7 @@ impl Labels {
             } else {
                 quote! {
                     miette::macro_helpers::OptionalWrapper::<#ty>::new().to_option(&self.#span)
-                    .map(|#var| miette::LabeledSpan::new_with_span(
+                    .map(|#var| #ctor(
                         std::option::Option::None,
                         #var.clone(),
                     ))
@@ -161,7 +199,7 @@ impl Labels {
                 let (display_pat, display_members) = display_pat_members(fields);
                 labels.as_ref().and_then(|labels| {
                     let variant_labels = labels.0.iter().map(|label| {
-                        let Label { span, label, ty } = label;
+                        let Label { span, label, ty, primary } = label;
                         let field = match &span {
                             syn::Member::Named(ident) => ident.clone(),
                             syn::Member::Unnamed(syn::Index { index, .. }) => {
@@ -169,11 +207,16 @@ impl Labels {
                             }
                         };
                         let var = quote! { __miette_internal_var };
+                        let ctor = if *primary {
+                            quote! { miette::LabeledSpan::new_primary_with_span }
+                        } else {
+                            quote! { miette::LabeledSpan::new_with_span }
+                        };
                         if let Some(display) = label {
                             let (fmt, args) = display.expand_shorthand_cloned(&display_members);
                             quote! {
                                 miette::macro_helpers::OptionalWrapper::<#ty>::new().to_option(#field)
-                                .map(|#var| miette::LabeledSpan::new_with_span(
+                                .map(|#var| #ctor(
                                     std::option::Option::Some(format!(#fmt #args)),
                                     #var.clone(),
                                 ))
@@ -181,7 +224,7 @@ impl Labels {
                         } else {
                             quote! {
                                 miette::macro_helpers::OptionalWrapper::<#ty>::new().to_option(#field)
-                                .map(|#var| miette::LabeledSpan::new_with_span(
+                                .map(|#var| #ctor(
                                     std::option::Option::None,
                                     #var.clone(),
                                 ))
diff --git a/src/handlers/graphical.rs b/src/handlers/graphical.rs
index e61f595..a7399fd 100644
--- a/src/handlers/graphical.rs
+++ b/src/handlers/graphical.rs
@@ -391,6 +391,11 @@ impl GraphicalReportHandler {
     ) -> fmt::Result {
         let (contents, lines) = self.get_lines(source, context.inner())?;
 
+        let primary_label = labels
+            .iter()
+            .find(|label| label.primary())
+            .or_else(|| labels.first());
+
         // sorting is your friend
         let labels = labels
             .iter()
@@ -431,19 +436,33 @@ impl GraphicalReportHandler {
             self.theme.characters.hbar,
         )?;
 
-        if let Some(source_name) = contents.name() {
+        // If there is a primary label, then use its span
+        // as the reference point for line/column information.
+        let primary_contents = match primary_label {
+            Some(label) => source
+                .read_span(label.inner(), 0, 0)
+                .map_err(|_| fmt::Error)?,
+            None => contents,
+        };
+
+        if let Some(source_name) = primary_contents.name() {
             let source_name = source_name.style(self.theme.styles.link);
             writeln!(
                 f,
                 "[{}:{}:{}]",
                 source_name,
-                contents.line() + 1,
-                contents.column() + 1
+                primary_contents.line() + 1,
+                primary_contents.column() + 1
             )?;
         } else if lines.len() <= 1 {
             writeln!(f, "{}", self.theme.characters.hbar.to_string().repeat(3))?;
         } else {
-            writeln!(f, "[{}:{}]", contents.line() + 1, contents.column() + 1)?;
+            writeln!(
+                f,
+                "[{}:{}]",
+                primary_contents.line() + 1,
+                primary_contents.column() + 1
+            )?;
         }
 
         // Now it's time for the fun part--actually rendering everything!
diff --git a/src/miette_diagnostic.rs b/src/miette_diagnostic.rs
index dc0468e..9863e88 100644
--- a/src/miette_diagnostic.rs
+++ b/src/miette_diagnostic.rs
@@ -292,14 +292,16 @@ fn test_serialize_miette_diagnostic() {
                     "offset": 0,
                     "length": 0
                 },
-                "label": "label1"
+                "label": "label1",
+                "primary": false
             },
             {
                 "span": {
                     "offset": 1,
                     "length": 2
                 },
-                "label": "label2"
+                "label": "label2",
+                "primary": false
             }
         ]
     });
@@ -350,14 +352,16 @@ fn test_deserialize_miette_diagnostic() {
                     "offset": 0,
                     "length": 0
                 },
-                "label": "label1"
+                "label": "label1",
+                "primary": false
             },
             {
                 "span": {
                     "offset": 1,
                     "length": 2
                 },
-                "label": "label2"
+                "label": "label2",
+                "primary": false
             }
         ]
     });
diff --git a/src/protocol.rs b/src/protocol.rs
index 36c3539..be313b1 100644
--- a/src/protocol.rs
+++ b/src/protocol.rs
@@ -249,6 +249,7 @@ pub struct LabeledSpan {
     #[cfg_attr(feature = "serde", serde(skip_serializing_if = "Option::is_none"))]
     label: Option<String>,
     span: SourceSpan,
+    primary: bool,
 }
 
 impl LabeledSpan {
@@ -257,6 +258,7 @@ impl LabeledSpan {
         Self {
             label,
             span: SourceSpan::new(SourceOffset(offset), SourceOffset(len)),
+            primary: false,
         }
     }
 
@@ -265,6 +267,16 @@ impl LabeledSpan {
         Self {
             label,
             span: span.into(),
+            primary: false,
+        }
+    }
+
+    /// Makes a new labeled primary span using an existing span.
+    pub fn new_primary_with_span(label: Option<String>, span: impl Into<SourceSpan>) -> Self {
+        Self {
+            label,
+            span: span.into(),
+            primary: true,
         }
     }
 
@@ -340,6 +352,11 @@ impl LabeledSpan {
     pub const fn is_empty(&self) -> bool {
         self.span.is_empty()
     }
+
+    /// True if this `LabeledSpan` is a primary span.
+    pub const fn primary(&self) -> bool {
+        self.primary
+    }
 }
 
 #[cfg(feature = "serde")]
@@ -350,7 +367,8 @@ fn test_serialize_labeled_span() {
     assert_eq!(
         json!(LabeledSpan::new(None, 0, 0)),
         json!({
-            "span": { "offset": 0, "length": 0 }
+            "span": { "offset": 0, "length": 0, },
+            "primary": false,
         })
     );
 
@@ -358,7 +376,8 @@ fn test_serialize_labeled_span() {
         json!(LabeledSpan::new(Some("label".to_string()), 0, 0)),
         json!({
             "label": "label",
-            "span": { "offset": 0, "length": 0 }
+            "span": { "offset": 0, "length": 0, },
+            "primary": false,
         })
     )
 }
@@ -370,20 +389,23 @@ fn test_deserialize_labeled_span() {
 
     let span: LabeledSpan = serde_json::from_value(json!({
         "label": null,
-        "span": { "offset": 0, "length": 0 }
+        "span": { "offset": 0, "length": 0, },
+        "primary": false,
     }))
     .unwrap();
     assert_eq!(span, LabeledSpan::new(None, 0, 0));
 
     let span: LabeledSpan = serde_json::from_value(json!({
-        "span": { "offset": 0, "length": 0 }
+        "span": { "offset": 0, "length": 0, },
+        "primary": false
     }))
     .unwrap();
     assert_eq!(span, LabeledSpan::new(None, 0, 0));
 
     let span: LabeledSpan = serde_json::from_value(json!({
         "label": "label",
-        "span": { "offset": 0, "length": 0 }
+        "span": { "offset": 0, "length": 0, },
+        "primary": false
     }))
     .unwrap();
     assert_eq!(span, LabeledSpan::new(Some("label".to_string()), 0, 0))
diff --git a/tests/graphical.rs b/tests/graphical.rs
index 0c69470..887e454 100644
--- a/tests/graphical.rs
+++ b/tests/graphical.rs
@@ -86,7 +86,7 @@ fn single_line_highlight_span_full_line() {
     println!("Error: {}", out);
 
     let expected = r#"  × oops!
-   ╭─[issue:1:1]
+   ╭─[issue:2:1]
  1 │ source
  2 │ text
    · ──┬─
@@ -120,7 +120,7 @@ fn single_line_with_wide_char() -> Result<(), MietteError> {
     let expected = r#"oops::my::bad
 
   × oops!
-   ╭─[bad_file.rs:1:1]
+   ╭─[bad_file.rs:2:7]
  1 │ source
  2 │   👼🏼text
    ·     ───┬──
@@ -159,7 +159,7 @@ fn single_line_with_two_tabs() -> Result<(), MietteError> {
     let expected = r#"oops::my::bad
 
   × oops!
-   ╭─[bad_file.rs:1:1]
+   ╭─[bad_file.rs:2:3]
  1 │ source
  2 │         text
    ·         ──┬─
@@ -198,7 +198,7 @@ fn single_line_with_tab_in_middle() -> Result<(), MietteError> {
     let expected = r#"oops::my::bad
 
   × oops!
-   ╭─[bad_file.rs:1:1]
+   ╭─[bad_file.rs:2:8]
  1 │ source
  2 │ text =  text
    ·         ──┬─
@@ -235,7 +235,7 @@ fn single_line_highlight() -> Result<(), MietteError> {
     let expected = r#"oops::my::bad
 
   × oops!
-   ╭─[bad_file.rs:1:1]
+   ╭─[bad_file.rs:2:3]
  1 │ source
  2 │   text
    ·   ──┬─
@@ -270,7 +270,7 @@ fn external_source() -> Result<(), MietteError> {
     let expected = r#"oops::my::bad
 
   × oops!
-   ╭─[bad_file.rs:1:1]
+   ╭─[bad_file.rs:2:3]
  1 │ source
  2 │   text
    ·   ──┬─
@@ -343,7 +343,7 @@ fn single_line_highlight_offset_end_of_line() -> Result<(), MietteError> {
     let expected = r#"oops::my::bad
 
   × oops!
-   ╭─[bad_file.rs:1:1]
+   ╭─[bad_file.rs:1:7]
  1 │ source
    ·       ▲
    ·       ╰── this bit here
@@ -379,7 +379,7 @@ fn single_line_highlight_include_end_of_line() -> Result<(), MietteError> {
     let expected = r#"oops::my::bad
 
   × oops!
-   ╭─[bad_file.rs:1:1]
+   ╭─[bad_file.rs:2:3]
  1 │ source
  2 │   text
    ·   ──┬──
@@ -416,7 +416,7 @@ fn single_line_highlight_include_end_of_line_crlf() -> Result<(), MietteError> {
     let expected = r#"oops::my::bad
 
   × oops!
-   ╭─[bad_file.rs:1:1]
+   ╭─[bad_file.rs:2:3]
  1 │ source
  2 │   text
    ·   ──┬──
@@ -453,7 +453,7 @@ fn single_line_highlight_with_empty_span() -> Result<(), MietteError> {
     let expected = r#"oops::my::bad
 
   × oops!
-   ╭─[bad_file.rs:1:1]
+   ╭─[bad_file.rs:2:3]
  1 │ source
  2 │   text
    ·   ▲
@@ -490,7 +490,7 @@ fn single_line_highlight_no_label() -> Result<(), MietteError> {
     let expected = r#"oops::my::bad
 
   × oops!
-   ╭─[bad_file.rs:1:1]
+   ╭─[bad_file.rs:2:3]
  1 │ source
  2 │   text
    ·   ────
@@ -526,7 +526,7 @@ fn single_line_highlight_at_line_start() -> Result<(), MietteError> {
     let expected = r#"oops::my::bad
 
   × oops!
-   ╭─[bad_file.rs:1:1]
+   ╭─[bad_file.rs:2:1]
  1 │ source
  2 │ text
    · ──┬─
@@ -569,7 +569,7 @@ fn multiple_same_line_highlights() -> Result<(), MietteError> {
     let expected = r#"oops::my::bad
 
   × oops!
-   ╭─[bad_file.rs:1:1]
+   ╭─[bad_file.rs:2:3]
  1 │ source
  2 │   text text text text text
    ·   ──┬─ ──┬─      ──┬─
@@ -616,7 +616,7 @@ fn multiple_same_line_highlights_with_tabs_in_middle() -> Result<(), MietteError
     let expected = r#"oops::my::bad
 
   × oops!
-   ╭─[bad_file.rs:1:1]
+   ╭─[bad_file.rs:2:3]
  1 │ source
  2 │   text text text    text text
    ·   ──┬─ ──┬─         ──┬─
@@ -655,7 +655,7 @@ fn multiline_highlight_adjacent() -> Result<(), MietteError> {
     let expected = r#"oops::my::bad
 
   × oops!
-   ╭─[bad_file.rs:1:1]
+   ╭─[bad_file.rs:2:3]
  1 │     source
  2 │ ╭─▶   text
  3 │ ├─▶     here
@@ -969,7 +969,7 @@ fn related() -> Result<(), MietteError> {
     let expected = r#"oops::my::bad
 
   × oops!
-   ╭─[bad_file.rs:1:1]
+   ╭─[bad_file.rs:2:3]
  1 │ source
  2 │   text
    ·   ──┬─
@@ -1031,7 +1031,7 @@ fn related_source_code_propagation() -> Result<(), MietteError> {
     let expected = r#"oops::my::bad
 
   × oops!
-   ╭─[bad_file.rs:1:1]
+   ╭─[bad_file.rs:2:3]
  1 │ source
  2 │   text
    ·   ──┬─
@@ -1136,7 +1136,7 @@ fn related_severity() -> Result<(), MietteError> {
     let expected = r#"oops::my::bad
 
   × oops!
-   ╭─[bad_file.rs:1:1]
+   ╭─[bad_file.rs:2:3]
  1 │ source
  2 │   text
    ·   ──┬─
@@ -1201,7 +1201,7 @@ fn zero_length_eol_span() {
     println!("Error: {}", out);
 
     let expected = r#"  × oops!
-   ╭─[issue:1:1]
+   ╭─[issue:2:1]
  1 │ this is the first line
  2 │ this is the second line
    · ▲
@@ -1212,3 +1212,38 @@ fn zero_length_eol_span() {
 
     assert_eq!(expected, out);
 }
+
+#[test]
+fn primary_label() {
+    #[derive(Error, Debug, Diagnostic)]
+    #[error("oops!")]
+    struct MyBad {
+        #[source_code]
+        src: NamedSource,
+        #[label]
+        first_label: SourceSpan,
+        #[label(primary, "nope")]
+        second_label: SourceSpan,
+    }
+    let err = MyBad {
+        src: NamedSource::new("issue", "this is the first line\nthis is the second line"),
+        first_label: (2, 4).into(),
+        second_label: (24, 4).into(),
+    };
+    let out = fmt_report(err.into());
+    println!("Error: {}", out);
+
+    // line 2 should be the primary, not line 1
+    let expected = r#"  × oops!
+   ╭─[issue:2:2]
+ 1 │ this is the first line
+   ·   ────
+ 2 │ this is the second line
+   ·  ──┬─
+   ·    ╰── nope
+   ╰────
+"#
+    .to_string();
+
+    assert_eq!(expected, out);
+}
diff --git a/tests/test_diagnostic_source_macro.rs b/tests/test_diagnostic_source_macro.rs
index df30b2e..0ca396a 100644
--- a/tests/test_diagnostic_source_macro.rs
+++ b/tests/test_diagnostic_source_macro.rs
@@ -91,7 +91,7 @@ fn test_diagnostic_source_pass_extra_info() {
     println!("Error: {}", out);
     let expected = r#"  × TestError
   ╰─▶   × A complex error happened
-         ╭─[1:1]
+         ╭─[1:2]
        1 │ Hello
          ·  ──┬─
          ·    ╰── here

From 1f448e47751d0f914134b0e9138fdb1a5a95d55c Mon Sep 17 00:00:00 2001
From: Bruce Mitchener <bruce.mitchener@gmail.com>
Date: Tue, 26 Sep 2023 00:31:44 +0700
Subject: [PATCH 12/67] fix(tests): Fix `cargo test` with default features.
 (#294)

A couple of tests require `fancy-no-backtrace`, so mark them
accordingly.
---
 tests/test_diagnostic_source_macro.rs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/tests/test_diagnostic_source_macro.rs b/tests/test_diagnostic_source_macro.rs
index 0ca396a..334ca34 100644
--- a/tests/test_diagnostic_source_macro.rs
+++ b/tests/test_diagnostic_source_macro.rs
@@ -75,6 +75,7 @@ fn test_diagnostic_source() {
     assert!(error.diagnostic_source().is_some());
 }
 
+#[cfg(feature = "fancy-no-backtrace")]
 #[test]
 fn test_diagnostic_source_pass_extra_info() {
     let diag = TestBoxedError(Box::new(SourceError {
@@ -106,6 +107,7 @@ fn test_diagnostic_source_pass_extra_info() {
     assert_eq!(expected, out);
 }
 
+#[cfg(feature = "fancy-no-backtrace")]
 #[test]
 fn test_diagnostic_source_is_output() {
     let diag = TestStructError {
@@ -147,6 +149,7 @@ struct NestedError {
     the_other_err: Box<dyn Diagnostic>,
 }
 
+#[cfg(feature = "fancy-no-backtrace")]
 #[test]
 fn test_nested_diagnostic_source_is_output() {
     let inner_error = TestStructError {

From 06b348230aaf153b8b050322f05e5d185351d2d1 Mon Sep 17 00:00:00 2001
From: Bruce Mitchener <bruce.mitchener@gmail.com>
Date: Tue, 26 Sep 2023 00:33:07 +0700
Subject: [PATCH 13/67] fix(clippy): Add missing semicolons where nothing is
 returned. (#293)

---
 src/handlers/graphical.rs |  4 ++--
 src/handlers/json.rs      |  2 +-
 src/protocol.rs           | 12 ++++++------
 tests/derive.rs           |  4 ++--
 4 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/src/handlers/graphical.rs b/src/handlers/graphical.rs
index a7399fd..770944d 100644
--- a/src/handlers/graphical.rs
+++ b/src/handlers/graphical.rs
@@ -678,10 +678,10 @@ impl GraphicalReportHandler {
         for (c, width) in text.chars().zip(self.line_visual_char_width(text)) {
             if c == '\t' {
                 for _ in 0..width {
-                    f.write_char(' ')?
+                    f.write_char(' ')?;
                 }
             } else {
-                f.write_char(c)?
+                f.write_char(c)?;
             }
         }
         f.write_char('\n')?;
diff --git a/src/handlers/json.rs b/src/handlers/json.rs
index 29e21a0..0b4a405 100644
--- a/src/handlers/json.rs
+++ b/src/handlers/json.rs
@@ -96,7 +96,7 @@ impl JSONReportHandler {
                 }
                 write!(f, r#""{}""#, escape(&error.to_string()))?;
             }
-            write!(f, "],")?
+            write!(f, "],")?;
         } else {
             write!(f, r#""causes": [],"#)?;
         }
diff --git a/src/protocol.rs b/src/protocol.rs
index be313b1..4a6012c 100644
--- a/src/protocol.rs
+++ b/src/protocol.rs
@@ -379,7 +379,7 @@ fn test_serialize_labeled_span() {
             "span": { "offset": 0, "length": 0, },
             "primary": false,
         })
-    )
+    );
 }
 
 #[cfg(feature = "serde")]
@@ -408,7 +408,7 @@ fn test_deserialize_labeled_span() {
         "primary": false
     }))
     .unwrap();
-    assert_eq!(span, LabeledSpan::new(Some("label".to_string()), 0, 0))
+    assert_eq!(span, LabeledSpan::new(Some("label".to_string()), 0, 0));
 }
 
 /**
@@ -597,7 +597,7 @@ fn test_serialize_source_span() {
     assert_eq!(
         json!(SourceSpan::from(0)),
         json!({ "offset": 0, "length": 0})
-    )
+    );
 }
 
 #[cfg(feature = "serde")]
@@ -606,7 +606,7 @@ fn test_deserialize_source_span() {
     use serde_json::json;
 
     let span: SourceSpan = serde_json::from_value(json!({ "offset": 0, "length": 0})).unwrap();
-    assert_eq!(span, SourceSpan::from(0))
+    assert_eq!(span, SourceSpan::from(0));
 }
 
 /**
@@ -708,12 +708,12 @@ fn test_source_offset_from_location() {
 fn test_serialize_source_offset() {
     use serde_json::json;
 
-    assert_eq!(json!(SourceOffset::from(0)), 0)
+    assert_eq!(json!(SourceOffset::from(0)), 0);
 }
 
 #[cfg(feature = "serde")]
 #[test]
 fn test_deserialize_source_offset() {
     let offset: SourceOffset = serde_json::from_str("0").unwrap();
-    assert_eq!(offset, SourceOffset::from(0))
+    assert_eq!(offset, SourceOffset::from(0));
 }
diff --git a/tests/derive.rs b/tests/derive.rs
index dbaf7cb..f4739a7 100644
--- a/tests/derive.rs
+++ b/tests/derive.rs
@@ -568,7 +568,7 @@ fn test_unit_struct_display() {
     #[error("unit only")]
     #[diagnostic(code(foo::bar::overridden), help("hello from unit help"))]
     struct UnitOnly;
-    assert_eq!(UnitOnly.help().unwrap().to_string(), "hello from unit help")
+    assert_eq!(UnitOnly.help().unwrap().to_string(), "hello from unit help");
 }
 
 #[test]
@@ -582,5 +582,5 @@ fn test_unit_enum_display() {
     assert_eq!(
         Enum::UnitVariant.help().unwrap().to_string(),
         "hello from unit help"
-    )
+    );
 }

From ba313282a8e6950fa7c19b9b66d45deb83aaa1bd Mon Sep 17 00:00:00 2001
From: Thomas Versteeg <t@versteeg.email>
Date: Fri, 29 Sep 2023 13:56:09 +0000
Subject: [PATCH 14/67] docs: typo in README.md (#295)

Dynamic diagnostics example contains a macro invocation without a '!' symbol.
---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 7aabe99..7d73ba3 100644
--- a/README.md
+++ b/README.md
@@ -615,7 +615,7 @@ then you may want to use [`miette!`], [`diagnostic!`] macros or
 
 let source = "2 + 2 * 2 = 8".to_string();
 let report = miette!(
-  labels = vec[
+  labels = vec![
       LabeledSpan::at(12..13, "this should be 6"),
   ],
   help = "'*' has greater precedence than '+'",

From 88d00e0e20bf95e03b8f81dcd5adf38c917e190e Mon Sep 17 00:00:00 2001
From: Gavrilikhin Daniil <gavrilikhin.daniil@gmail.com>
Date: Sat, 21 Oct 2023 11:50:15 +0800
Subject: [PATCH 15/67] feat(derive): Allow optional sources in derive (#301)

Fixes: https://github.com/zkat/miette/issues/217
---
 miette-derive/src/source_code.rs | 42 +++++++++++++++++++++++++++++---
 tests/derive.rs                  | 42 ++++++++++++++++++++++++++++++++
 2 files changed, 81 insertions(+), 3 deletions(-)

diff --git a/miette-derive/src/source_code.rs b/miette-derive/src/source_code.rs
index 62f28e7..e1b85ab 100644
--- a/miette-derive/src/source_code.rs
+++ b/miette-derive/src/source_code.rs
@@ -10,6 +10,7 @@ use crate::{
 
 pub struct SourceCode {
     source_code: syn::Member,
+    is_option: bool,
 }
 
 impl SourceCode {
@@ -27,6 +28,19 @@ impl SourceCode {
         for (i, field) in fields.iter().enumerate() {
             for attr in &field.attrs {
                 if attr.path().is_ident("source_code") {
+                    let is_option = if let syn::Type::Path(syn::TypePath {
+                        path: syn::Path { segments, .. },
+                        ..
+                    }) = &field.ty
+                    {
+                        segments
+                            .last()
+                            .map(|seg| seg.ident == "Option")
+                            .unwrap_or(false)
+                    } else {
+                        false
+                    };
+
                     let source_code = if let Some(ident) = field.ident.clone() {
                         syn::Member::Named(ident)
                     } else {
@@ -35,7 +49,10 @@ impl SourceCode {
                             span: field.span(),
                         })
                     };
-                    return Ok(Some(SourceCode { source_code }));
+                    return Ok(Some(SourceCode {
+                        source_code,
+                        is_option,
+                    }));
                 }
             }
         }
@@ -45,11 +62,21 @@ impl SourceCode {
     pub(crate) fn gen_struct(&self, fields: &syn::Fields) -> Option<TokenStream> {
         let (display_pat, _display_members) = display_pat_members(fields);
         let src = &self.source_code;
+        let ret = if self.is_option {
+            quote! {
+                self.#src.as_ref().map(|s| s as _)
+            }
+        } else {
+            quote! {
+                Some(&self.#src)
+            }
+        };
+
         Some(quote! {
             #[allow(unused_variables)]
             fn source_code(&self) -> std::option::Option<&dyn miette::SourceCode> {
                 let Self #display_pat = self;
-                Some(&self.#src)
+                #ret
             }
         })
     }
@@ -68,10 +95,19 @@ impl SourceCode {
                         }
                     };
                     let variant_name = ident.clone();
+                    let ret = if source_code.is_option {
+                        quote! {
+                            #field.as_ref().map(|s| s as _)
+                        }
+                    } else {
+                        quote! {
+                            std::option::Option::Some(#field)
+                        }
+                    };
                     match &fields {
                         syn::Fields::Unit => None,
                         _ => Some(quote! {
-                            Self::#variant_name #display_pat => std::option::Option::Some(#field),
+                            Self::#variant_name #display_pat => #ret,
                         }),
                     }
                 })
diff --git a/tests/derive.rs b/tests/derive.rs
index f4739a7..d1da1bb 100644
--- a/tests/derive.rs
+++ b/tests/derive.rs
@@ -584,3 +584,45 @@ fn test_unit_enum_display() {
         "hello from unit help"
     );
 }
+
+#[test]
+fn test_optional_source_code() {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("struct with optional source")]
+    struct Struct {
+        #[source_code]
+        src: Option<String>,
+    }
+    assert!(Struct { src: None }.source_code().is_none());
+    assert!(Struct {
+        src: Some("".to_string())
+    }
+    .source_code()
+    .is_some());
+
+    #[derive(Debug, Diagnostic, Error)]
+    enum Enum {
+        #[error("variant1 with optional source")]
+        Variant1 {
+            #[source_code]
+            src: Option<String>,
+        },
+        #[error("variant2 with optional source")]
+        Variant2 {
+            #[source_code]
+            src: Option<String>,
+        },
+    }
+    assert!(Enum::Variant1 { src: None }.source_code().is_none());
+    assert!(Enum::Variant1 {
+        src: Some("".to_string())
+    }
+    .source_code()
+    .is_some());
+    assert!(Enum::Variant2 { src: None }.source_code().is_none());
+    assert!(Enum::Variant2 {
+        src: Some("".to_string())
+    }
+    .source_code()
+    .is_some());
+}

From d37ada876a5831d3f47622274e334c9a24aa5d2b Mon Sep 17 00:00:00 2001
From: Andre Meyering <info@andremeyering.de>
Date: Mon, 23 Oct 2023 19:09:00 +0200
Subject: [PATCH 16/67] docs(README): Move import of `NamedResult` to where it
 is used (#309)

An example in README.md makes use of `miette::NamedResult` .
It is imported in the second "example-step", but already used in the first one. Beginners, that copy the example step-by-step to understand it, will run into compile errors, as `NamedResult` was not imported.
---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 7d73ba3..a29b428 100644
--- a/README.md
+++ b/README.md
@@ -96,7 +96,7 @@ You can derive a `Diagnostic` from any `std::error::Error` type.
 
 `thiserror` is a great way to define them, and plays nicely with `miette`!
 */
-use miette::{Diagnostic, SourceSpan};
+use miette::{Diagnostic, NamedSource, SourceSpan};
 use thiserror::Error;
 
 #[derive(Error, Debug, Diagnostic)]
@@ -123,7 +123,7 @@ Use this `Result` type (or its expanded version) as the return type
 throughout your app (but NOT your libraries! Those should always return
 concrete types!).
 */
-use miette::{NamedSource, Result};
+use miette::Result;
 fn this_fails() -> Result<()> {
     // You can use plain strings as a `Source`, or anything that implements
     // the one-method `Source` trait.

From a8b4ae012aa0cf03b53a18f013c2b3f76c5040e7 Mon Sep 17 00:00:00 2001
From: Matt <matthieufelix@gmail.com>
Date: Thu, 2 Nov 2023 12:33:55 -0400
Subject: [PATCH 17/67] fix(graphical): Extend error text span to whole code
 points (#312)

Fixes: https://github.com/zkat/miette/issues/223

This fixes a panic when an error starts inside a Unicode code point. The
range is extended to start (or end) at the beginning (or end) of the
character inside which the byte offset is located.
---
 src/handlers/graphical.rs | 19 +++++++---
 tests/graphical.rs        | 74 +++++++++++++++++++++++++++++++++++++++
 2 files changed, 89 insertions(+), 4 deletions(-)

diff --git a/src/handlers/graphical.rs b/src/handlers/graphical.rs
index 770944d..44d92b7 100644
--- a/src/handlers/graphical.rs
+++ b/src/handlers/graphical.rs
@@ -651,11 +651,22 @@ impl GraphicalReportHandler {
     }
 
     /// Returns the visual column position of a byte offset on a specific line.
-    fn visual_offset(&self, line: &Line, offset: usize) -> usize {
+    ///
+    /// If the offset occurs in the middle of a character, the returned column
+    /// corresponds to that character's first column in `start` is true, or its
+    /// last column if `start` is false.
+    fn visual_offset(&self, line: &Line, offset: usize, start: bool) -> usize {
         let line_range = line.offset..=(line.offset + line.length);
         assert!(line_range.contains(&offset));
 
-        let text_index = offset - line.offset;
+        let mut text_index = offset - line.offset;
+        while text_index <= line.text.len() && !line.text.is_char_boundary(text_index) {
+            if start {
+                text_index -= 1;
+            } else {
+                text_index += 1;
+            }
+        }
         let text = &line.text[..text_index.min(line.text.len())];
         let text_width = self.line_visual_char_width(text).sum();
         if text_index > line.text.len() {
@@ -706,8 +717,8 @@ impl GraphicalReportHandler {
             .map(|hl| {
                 let byte_start = hl.offset();
                 let byte_end = hl.offset() + hl.len();
-                let start = self.visual_offset(line, byte_start).max(highest);
-                let end = self.visual_offset(line, byte_end).max(start + 1);
+                let start = self.visual_offset(line, byte_start, true).max(highest);
+                let end = self.visual_offset(line, byte_end, false).max(start + 1);
 
                 let vbar_offset = (start + end) / 2;
                 let num_left = vbar_offset - start;
diff --git a/tests/graphical.rs b/tests/graphical.rs
index 887e454..31db4dc 100644
--- a/tests/graphical.rs
+++ b/tests/graphical.rs
@@ -1247,3 +1247,77 @@ fn primary_label() {
 
     assert_eq!(expected, out);
 }
+
+#[test]
+fn single_line_with_wide_char_unaligned_span_start() -> Result<(), MietteError> {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("oops!")]
+    #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
+    struct MyBad {
+        #[source_code]
+        src: NamedSource,
+        #[label("this bit here")]
+        highlight: SourceSpan,
+    }
+
+    let src = "source\n  👼🏼text\n    here".to_string();
+    let err = MyBad {
+        src: NamedSource::new("bad_file.rs", src),
+        highlight: (10, 5).into(),
+    };
+    let out = fmt_report(err.into());
+    println!("Error: {}", out);
+    let expected = r#"oops::my::bad
+
+  × oops!
+   ╭─[bad_file.rs:2:4]
+ 1 │ source
+ 2 │   👼🏼text
+   ·   ──┬─
+   ·     ╰── this bit here
+ 3 │     here
+   ╰────
+  help: try doing it better next time?
+"#
+    .trim_start()
+    .to_string();
+    assert_eq!(expected, out);
+    Ok(())
+}
+
+#[test]
+fn single_line_with_wide_char_unaligned_span_end() -> Result<(), MietteError> {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("oops!")]
+    #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
+    struct MyBad {
+        #[source_code]
+        src: NamedSource,
+        #[label("this bit here")]
+        highlight: SourceSpan,
+    }
+
+    let src = "source\n  text 👼🏼\n    here".to_string();
+    let err = MyBad {
+        src: NamedSource::new("bad_file.rs", src),
+        highlight: (9, 6).into(),
+    };
+    let out = fmt_report(err.into());
+    println!("Error: {}", out);
+    let expected = r#"oops::my::bad
+
+  × oops!
+   ╭─[bad_file.rs:2:3]
+ 1 │ source
+ 2 │   text 👼🏼
+   ·   ───┬───
+   ·      ╰── this bit here
+ 3 │     here
+   ╰────
+  help: try doing it better next time?
+"#
+    .trim_start()
+    .to_string();
+    assert_eq!(expected, out);
+    Ok(())
+}

From 3d6f903df0e7c9d0eb9a1fdbbf0028bab5496429 Mon Sep 17 00:00:00 2001
From: Benjamin Lee <benjamin@computer.surgery>
Date: Thu, 9 Nov 2023 13:21:32 -0800
Subject: [PATCH 18/67] fix(formatting): Fix formatting bug when an empty span
 is not aligned to a char boundary (#314)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Previous output looked like this:

---- single_line_with_wide_char_unaligned_span_empty stdout ----
Error: oops::my::bad

  × oops!
   ╭─[bad_file.rs:2:4]
 1 │ source
 2 │   👼🏼text
   ·   ─▲
   ·    ╰── this bit here
 3 │     here
   ╰────
  help: try doing it better next time?

Note that the .max(start + 1) term is still necessary in the nonempty
branch, since it's possible to have a nonempty span covering zero-width
text.

* remove uncessary if statement

start > end in all cases.
---
 src/handlers/graphical.rs | 44 ++++++++++++++++++++-------------------
 tests/graphical.rs        | 37 ++++++++++++++++++++++++++++++++
 2 files changed, 60 insertions(+), 21 deletions(-)

diff --git a/src/handlers/graphical.rs b/src/handlers/graphical.rs
index 44d92b7..8cec88b 100644
--- a/src/handlers/graphical.rs
+++ b/src/handlers/graphical.rs
@@ -718,31 +718,33 @@ impl GraphicalReportHandler {
                 let byte_start = hl.offset();
                 let byte_end = hl.offset() + hl.len();
                 let start = self.visual_offset(line, byte_start, true).max(highest);
-                let end = self.visual_offset(line, byte_end, false).max(start + 1);
+                let end = if hl.len() == 0 {
+                    start + 1
+                } else {
+                    self.visual_offset(line, byte_end, false).max(start + 1)
+                };
 
                 let vbar_offset = (start + end) / 2;
                 let num_left = vbar_offset - start;
                 let num_right = end - vbar_offset - 1;
-                if start < end {
-                    underlines.push_str(
-                        &format!(
-                            "{:width$}{}{}{}",
-                            "",
-                            chars.underline.to_string().repeat(num_left),
-                            if hl.len() == 0 {
-                                chars.uarrow
-                            } else if hl.label().is_some() {
-                                chars.underbar
-                            } else {
-                                chars.underline
-                            },
-                            chars.underline.to_string().repeat(num_right),
-                            width = start.saturating_sub(highest),
-                        )
-                        .style(hl.style)
-                        .to_string(),
-                    );
-                }
+                underlines.push_str(
+                    &format!(
+                        "{:width$}{}{}{}",
+                        "",
+                        chars.underline.to_string().repeat(num_left),
+                        if hl.len() == 0 {
+                            chars.uarrow
+                        } else if hl.label().is_some() {
+                            chars.underbar
+                        } else {
+                            chars.underline
+                        },
+                        chars.underline.to_string().repeat(num_right),
+                        width = start.saturating_sub(highest),
+                    )
+                    .style(hl.style)
+                    .to_string(),
+                );
                 highest = std::cmp::max(highest, end);
 
                 (hl, vbar_offset)
diff --git a/tests/graphical.rs b/tests/graphical.rs
index 31db4dc..d24879a 100644
--- a/tests/graphical.rs
+++ b/tests/graphical.rs
@@ -1321,3 +1321,40 @@ fn single_line_with_wide_char_unaligned_span_end() -> Result<(), MietteError> {
     assert_eq!(expected, out);
     Ok(())
 }
+
+#[test]
+fn single_line_with_wide_char_unaligned_span_empty() -> Result<(), MietteError> {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("oops!")]
+    #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
+    struct MyBad {
+        #[source_code]
+        src: NamedSource,
+        #[label("this bit here")]
+        highlight: SourceSpan,
+    }
+
+    let src = "source\n  👼🏼text\n    here".to_string();
+    let err = MyBad {
+        src: NamedSource::new("bad_file.rs", src),
+        highlight: (10, 0).into(),
+    };
+    let out = fmt_report(err.into());
+    println!("Error: {}", out);
+    let expected = r#"oops::my::bad
+
+  × oops!
+   ╭─[bad_file.rs:2:4]
+ 1 │ source
+ 2 │   👼🏼text
+   ·   ▲
+   ·   ╰── this bit here
+ 3 │     here
+   ╰────
+  help: try doing it better next time?
+"#
+    .trim_start()
+    .to_string();
+    assert_eq!(expected, out);
+    Ok(())
+}

From c7ba5b7e52e05991cecd3ca925c710bbe49850b9 Mon Sep 17 00:00:00 2001
From: ManicMarrc <122530518+ManicMarrc@users.noreply.github.com>
Date: Fri, 10 Nov 2023 04:22:47 +0700
Subject: [PATCH 19/67] feat(derive): Make `miette-derive` be able to be turned
 off (#304)

---
 Cargo.toml   |  5 +++--
 src/error.rs | 42 +++++++++++++++++++++++++++++++++---------
 src/lib.rs   |  1 +
 3 files changed, 37 insertions(+), 11 deletions(-)

diff --git a/Cargo.toml b/Cargo.toml
index dd6e584..f8c2cb5 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -14,7 +14,7 @@ exclude = ["images/", "tests/", "miette-derive/"]
 
 [dependencies]
 thiserror = "1.0.40"
-miette-derive = { path = "miette-derive", version = "=5.10.0" }
+miette-derive = { path = "miette-derive", version = "=5.10.0", optional = true }
 once_cell = "1.8.0"
 unicode-width = "0.1.9"
 
@@ -44,7 +44,8 @@ lazy_static = "1.4"
 serde_json = "1.0.64"
 
 [features]
-default = []
+default = ["derive"]
+derive = ["miette-derive"]
 no-format-args-capture = []
 fancy-no-backtrace = [
     "owo-colors",
diff --git a/src/error.rs b/src/error.rs
index 56041ca..4e57a78 100644
--- a/src/error.rs
+++ b/src/error.rs
@@ -1,27 +1,51 @@
-use std::io;
+use std::{fmt, io};
 
 use thiserror::Error;
 
-use crate::{self as miette, Diagnostic};
+use crate::Diagnostic;
 
 /**
 Error enum for miette. Used by certain operations in the protocol.
 */
-#[derive(Debug, Diagnostic, Error)]
+#[derive(Debug, Error)]
 pub enum MietteError {
     /// Wrapper around [`std::io::Error`]. This is returned when something went
     /// wrong while reading a [`SourceCode`](crate::SourceCode).
     #[error(transparent)]
-    #[diagnostic(code(miette::io_error), url(docsrs))]
     IoError(#[from] io::Error),
 
     /// Returned when a [`SourceSpan`](crate::SourceSpan) extends beyond the
     /// bounds of a given [`SourceCode`](crate::SourceCode).
     #[error("The given offset is outside the bounds of its Source")]
-    #[diagnostic(
-        code(miette::span_out_of_bounds),
-        help("Double-check your spans. Do you have an off-by-one error?"),
-        url(docsrs)
-    )]
     OutOfBounds,
 }
+
+impl Diagnostic for MietteError {
+    fn code<'a>(&'a self) -> Option<Box<dyn fmt::Display + 'a>> {
+        match self {
+            MietteError::IoError(_) => Some(Box::new("miette::io_error")),
+            MietteError::OutOfBounds => Some(Box::new("miette::span_out_of_bounds")),
+        }
+    }
+
+    fn help<'a>(&'a self) -> Option<Box<dyn fmt::Display + 'a>> {
+        match self {
+            MietteError::IoError(_) => None,
+            MietteError::OutOfBounds => Some(Box::new(
+                "Double-check your spans. Do you have an off-by-one error?",
+            )),
+        }
+    }
+
+    fn url<'a>(&'a self) -> Option<Box<dyn fmt::Display + 'a>> {
+        let crate_version = env!("CARGO_PKG_VERSION");
+        let variant = match self {
+            MietteError::IoError(_) => "#variant.IoError",
+            MietteError::OutOfBounds => "#variant.OutOfBounds",
+        };
+        Some(Box::new(format!(
+            "https://docs.rs/miette/{}/miette/enum.MietteError.html{}",
+            crate_version, variant,
+        )))
+    }
+}
diff --git a/src/lib.rs b/src/lib.rs
index 20589ef..3cb021b 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -652,6 +652,7 @@
 //! and some from [`thiserror`](https://github.com/dtolnay/thiserror), also
 //! under the Apache License. Some code is taken from
 //! [`ariadne`](https://github.com/zesterer/ariadne), which is MIT licensed.
+#[cfg(feature = "derive")]
 pub use miette_derive::*;
 
 pub use error::*;

From fd77257cee0f5d03aa7dccb4ba8cbaa40c1a88c6 Mon Sep 17 00:00:00 2001
From: Zanie Blue <contact@zanie.dev>
Date: Wed, 15 Nov 2023 12:34:24 -0600
Subject: [PATCH 20/67] feat(graphical): Expose additional `textwrap` options
 (#321)

---
 src/handler.rs            |  34 +++++++
 src/handlers/graphical.rs |  74 +++++++++++++--
 src/lib.rs                |   1 +
 tests/graphical.rs        | 184 ++++++++++++++++++++++++++++++++++++++
 4 files changed, 285 insertions(+), 8 deletions(-)

diff --git a/src/handler.rs b/src/handler.rs
index e983a55..e32f3ef 100644
--- a/src/handler.rs
+++ b/src/handler.rs
@@ -55,6 +55,9 @@ pub struct MietteHandlerOpts {
     pub(crate) context_lines: Option<usize>,
     pub(crate) tab_width: Option<usize>,
     pub(crate) with_cause_chain: Option<bool>,
+    pub(crate) break_words: Option<bool>,
+    pub(crate) word_separator: Option<textwrap::WordSeparator>,
+    pub(crate) word_splitter: Option<textwrap::WordSplitter>,
 }
 
 impl MietteHandlerOpts {
@@ -86,6 +89,27 @@ impl MietteHandlerOpts {
         self
     }
 
+    /// If true, long words can be broken when wrapping.
+    ///
+    /// If false, long words will not be broken when they exceed the width.
+    ///
+    /// Defaults to true.
+    pub fn break_words(mut self, break_words: bool) -> Self {
+        self.break_words = Some(break_words);
+        self
+    }
+
+    /// Sets the `textwrap::WordSeparator` to use when determining wrap points.
+    pub fn word_separator(mut self, word_separator: textwrap::WordSeparator) -> Self {
+        self.word_separator = Some(word_separator);
+        self
+    }
+
+    /// Sets the `textwrap::WordSplitter` to use when determining wrap points.
+    pub fn word_splitter(mut self, word_splitter: textwrap::WordSplitter) -> Self {
+        self.word_splitter = Some(word_splitter);
+        self
+    }
     /// Include the cause chain of the top-level error in the report.
     pub fn with_cause_chain(mut self) -> Self {
         self.with_cause_chain = Some(true);
@@ -233,6 +257,16 @@ impl MietteHandlerOpts {
             if let Some(w) = self.tab_width {
                 handler = handler.tab_width(w);
             }
+            if let Some(b) = self.break_words {
+                handler = handler.with_break_words(b)
+            }
+            if let Some(s) = self.word_separator {
+                handler = handler.with_word_separator(s)
+            }
+            if let Some(s) = self.word_splitter {
+                handler = handler.with_word_splitter(s)
+            }
+
             MietteHandler {
                 inner: Box::new(handler),
             }
diff --git a/src/handlers/graphical.rs b/src/handlers/graphical.rs
index 8cec88b..35e9c79 100644
--- a/src/handlers/graphical.rs
+++ b/src/handlers/graphical.rs
@@ -30,6 +30,9 @@ pub struct GraphicalReportHandler {
     pub(crate) context_lines: usize,
     pub(crate) tab_width: usize,
     pub(crate) with_cause_chain: bool,
+    pub(crate) break_words: bool,
+    pub(crate) word_separator: Option<textwrap::WordSeparator>,
+    pub(crate) word_splitter: Option<textwrap::WordSplitter>,
 }
 
 #[derive(Debug, Clone, Copy, PartialEq, Eq)]
@@ -51,6 +54,9 @@ impl GraphicalReportHandler {
             context_lines: 1,
             tab_width: 4,
             with_cause_chain: true,
+            break_words: true,
+            word_separator: None,
+            word_splitter: None,
         }
     }
 
@@ -64,6 +70,9 @@ impl GraphicalReportHandler {
             context_lines: 1,
             tab_width: 4,
             with_cause_chain: true,
+            break_words: true,
+            word_separator: None,
+            word_splitter: None,
         }
     }
 
@@ -122,6 +131,24 @@ impl GraphicalReportHandler {
         self
     }
 
+    /// Enables or disables breaking of words during wrapping.
+    pub fn with_break_words(mut self, break_words: bool) -> Self {
+        self.break_words = break_words;
+        self
+    }
+
+    /// Sets the word separator to use when wrapping.
+    pub fn with_word_separator(mut self, word_separator: textwrap::WordSeparator) -> Self {
+        self.word_separator = Some(word_separator);
+        self
+    }
+
+    /// Sets the word splitter to usewhen wrapping.
+    pub fn with_word_splitter(mut self, word_splitter: textwrap::WordSplitter) -> Self {
+        self.word_splitter = Some(word_splitter);
+        self
+    }
+
     /// Sets the 'global' footer for this handler.
     pub fn with_footer(mut self, footer: String) -> Self {
         self.footer = Some(footer);
@@ -159,9 +186,17 @@ impl GraphicalReportHandler {
         if let Some(footer) = &self.footer {
             writeln!(f)?;
             let width = self.termwidth.saturating_sub(4);
-            let opts = textwrap::Options::new(width)
+            let mut opts = textwrap::Options::new(width)
                 .initial_indent("  ")
-                .subsequent_indent("  ");
+                .subsequent_indent("  ")
+                .break_words(self.break_words);
+            if let Some(word_separator) = self.word_separator {
+                opts = opts.word_separator(word_separator);
+            }
+            if let Some(word_splitter) = self.word_splitter.clone() {
+                opts = opts.word_splitter(word_splitter);
+            }
+
             writeln!(f, "{}", textwrap::fill(footer, opts))?;
         }
         Ok(())
@@ -212,9 +247,16 @@ impl GraphicalReportHandler {
         let initial_indent = format!("  {} ", severity_icon.style(severity_style));
         let rest_indent = format!("  {} ", self.theme.characters.vbar.style(severity_style));
         let width = self.termwidth.saturating_sub(2);
-        let opts = textwrap::Options::new(width)
+        let mut opts = textwrap::Options::new(width)
             .initial_indent(&initial_indent)
-            .subsequent_indent(&rest_indent);
+            .subsequent_indent(&rest_indent)
+            .break_words(self.break_words);
+        if let Some(word_separator) = self.word_separator {
+            opts = opts.word_separator(word_separator);
+        }
+        if let Some(word_splitter) = self.word_splitter.clone() {
+            opts = opts.word_splitter(word_splitter);
+        }
 
         writeln!(f, "{}", textwrap::fill(&diagnostic.to_string(), opts))?;
 
@@ -251,9 +293,17 @@ impl GraphicalReportHandler {
                 )
                 .style(severity_style)
                 .to_string();
-                let opts = textwrap::Options::new(width)
+                let mut opts = textwrap::Options::new(width)
                     .initial_indent(&initial_indent)
-                    .subsequent_indent(&rest_indent);
+                    .subsequent_indent(&rest_indent)
+                    .break_words(self.break_words);
+                if let Some(word_separator) = self.word_separator {
+                    opts = opts.word_separator(word_separator);
+                }
+                if let Some(word_splitter) = self.word_splitter.clone() {
+                    opts = opts.word_splitter(word_splitter);
+                }
+
                 match error {
                     ErrorKind::Diagnostic(diag) => {
                         let mut inner = String::new();
@@ -280,9 +330,17 @@ impl GraphicalReportHandler {
         if let Some(help) = diagnostic.help() {
             let width = self.termwidth.saturating_sub(4);
             let initial_indent = "  help: ".style(self.theme.styles.help).to_string();
-            let opts = textwrap::Options::new(width)
+            let mut opts = textwrap::Options::new(width)
                 .initial_indent(&initial_indent)
-                .subsequent_indent("        ");
+                .subsequent_indent("        ")
+                .break_words(self.break_words);
+            if let Some(word_separator) = self.word_separator {
+                opts = opts.word_separator(word_separator);
+            }
+            if let Some(word_splitter) = self.word_splitter.clone() {
+                opts = opts.word_splitter(word_splitter);
+            }
+
             writeln!(f, "{}", textwrap::fill(&help.to_string(), opts))?;
         }
         Ok(())
diff --git a/src/lib.rs b/src/lib.rs
index 3cb021b..08de732 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -593,6 +593,7 @@
 //!             .unicode(false)
 //!             .context_lines(3)
 //!             .tab_width(4)
+//!             .break_words(true)
 //!             .build(),
 //!     )
 //! }))
diff --git a/tests/graphical.rs b/tests/graphical.rs
index d24879a..536efcd 100644
--- a/tests/graphical.rs
+++ b/tests/graphical.rs
@@ -34,6 +34,190 @@ fn fmt_report(diag: Report) -> String {
     out
 }
 
+fn fmt_report_with_settings(
+    diag: Report,
+    with_settings: fn(GraphicalReportHandler) -> GraphicalReportHandler,
+) -> String {
+    let mut out = String::new();
+
+    let handler = with_settings(GraphicalReportHandler::new_themed(
+        GraphicalTheme::unicode_nocolor(),
+    ));
+
+    handler.render_report(&mut out, diag.as_ref()).unwrap();
+
+    println!("Error:\n```\n{}\n```", out);
+
+    out
+}
+
+#[test]
+fn word_wrap_options() -> Result<(), MietteError> {
+    // By default, a long word should not break
+    let out =
+        fmt_report_with_settings(Report::msg("abcdefghijklmnopqrstuvwxyz"), |handler| handler);
+
+    let expected = "  × abcdefghijklmnopqrstuvwxyz\n".to_string();
+    assert_eq!(expected, out);
+
+    // A long word can break with a smaller width
+    let out = fmt_report_with_settings(Report::msg("abcdefghijklmnopqrstuvwxyz"), |handler| {
+        handler.with_width(10)
+    });
+    let expected = r#"  × abcd
+  │ efgh
+  │ ijkl
+  │ mnop
+  │ qrst
+  │ uvwx
+  │ yz
+"#
+    .to_string();
+    assert_eq!(expected, out);
+
+    // Unless, word breaking is disabled
+    let out = fmt_report_with_settings(Report::msg("abcdefghijklmnopqrstuvwxyz"), |handler| {
+        handler.with_width(10).with_break_words(false)
+    });
+    let expected = "  × abcdefghijklmnopqrstuvwxyz\n".to_string();
+    assert_eq!(expected, out);
+
+    // Breaks should start at the boundary of each word if possible
+    let out = fmt_report_with_settings(
+        Report::msg("12 123 1234 12345 123456 1234567 1234567890"),
+        |handler| handler.with_width(10),
+    );
+    let expected = r#"  × 12
+  │ 123
+  │ 1234
+  │ 1234
+  │ 5
+  │ 1234
+  │ 56
+  │ 1234
+  │ 567
+  │ 1234
+  │ 5678
+  │ 90
+"#
+    .to_string();
+    assert_eq!(expected, out);
+
+    // But long words should not break if word breaking is disabled
+    let out = fmt_report_with_settings(
+        Report::msg("12 123 1234 12345 123456 1234567 1234567890"),
+        |handler| handler.with_width(10).with_break_words(false),
+    );
+    let expected = r#"  × 12
+  │ 123
+  │ 1234
+  │ 12345
+  │ 123456
+  │ 1234567
+  │ 1234567890
+"#
+    .to_string();
+    assert_eq!(expected, out);
+
+    // Unless, of course, there are hyphens
+    let out = fmt_report_with_settings(
+        Report::msg("a-b a-b-c a-b-c-d a-b-c-d-e a-b-c-d-e-f a-b-c-d-e-f-g a-b-c-d-e-f-g-h"),
+        |handler| handler.with_width(10).with_break_words(false),
+    );
+    let expected = r#"  × a-b
+  │ a-b-
+  │ c a-
+  │ b-c-
+  │ d a-
+  │ b-c-
+  │ d-e
+  │ a-b-
+  │ c-d-
+  │ e-f
+  │ a-b-
+  │ c-d-
+  │ e-f-
+  │ g a-
+  │ b-c-
+  │ d-e-
+  │ f-g-
+  │ h
+"#
+    .to_string();
+    assert_eq!(expected, out);
+
+    // Which requires an additional opt-out
+    let out = fmt_report_with_settings(
+        Report::msg("a-b a-b-c a-b-c-d a-b-c-d-e a-b-c-d-e-f a-b-c-d-e-f-g a-b-c-d-e-f-g-h"),
+        |handler| {
+            handler
+                .with_width(10)
+                .with_break_words(false)
+                .with_word_splitter(textwrap::WordSplitter::NoHyphenation)
+        },
+    );
+    let expected = r#"  × a-b
+  │ a-b-c
+  │ a-b-c-d
+  │ a-b-c-d-e
+  │ a-b-c-d-e-f
+  │ a-b-c-d-e-f-g
+  │ a-b-c-d-e-f-g-h
+"#
+    .to_string();
+    assert_eq!(expected, out);
+
+    // Or if there are _other_ unicode word boundaries
+    let out = fmt_report_with_settings(
+        Report::msg("a/b a/b/c a/b/c/d a/b/c/d/e a/b/c/d/e/f a/b/c/d/e/f/g a/b/c/d/e/f/g/h"),
+        |handler| handler.with_width(10).with_break_words(false),
+    );
+    let expected = r#"  × a/b
+  │ a/b/
+  │ c a/
+  │ b/c/
+  │ d a/
+  │ b/c/
+  │ d/e
+  │ a/b/
+  │ c/d/
+  │ e/f
+  │ a/b/
+  │ c/d/
+  │ e/f/
+  │ g a/
+  │ b/c/
+  │ d/e/
+  │ f/g/
+  │ h
+"#
+    .to_string();
+    assert_eq!(expected, out);
+
+    // Such things require you to opt-in to only breaking on ASCII whitespace
+    let out = fmt_report_with_settings(
+        Report::msg("a/b a/b/c a/b/c/d a/b/c/d/e a/b/c/d/e/f a/b/c/d/e/f/g a/b/c/d/e/f/g/h"),
+        |handler| {
+            handler
+                .with_width(10)
+                .with_break_words(false)
+                .with_word_separator(textwrap::WordSeparator::AsciiSpace)
+        },
+    );
+    let expected = r#"  × a/b
+  │ a/b/c
+  │ a/b/c/d
+  │ a/b/c/d/e
+  │ a/b/c/d/e/f
+  │ a/b/c/d/e/f/g
+  │ a/b/c/d/e/f/g/h
+"#
+    .to_string();
+    assert_eq!(expected, out);
+
+    Ok(())
+}
+
 #[test]
 fn empty_source() -> Result<(), MietteError> {
     #[derive(Debug, Diagnostic, Error)]

From 251d6d59292397458328ef57fb7957faedafd019 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jonathan=20D=C3=B6nszelmann?= <jonabent@gmail.com>
Date: Wed, 15 Nov 2023 19:35:46 +0100
Subject: [PATCH 21/67] fix(docs): add example to README and docs fixing #96
 (#319)

---
 README.md  | 17 +++++++++++++++++
 src/lib.rs | 17 +++++++++++++++++
 2 files changed, 34 insertions(+)

diff --git a/README.md b/README.md
index a29b428..5f79c52 100644
--- a/README.md
+++ b/README.md
@@ -305,6 +305,23 @@ enabled:
 miette = { version = "X.Y.Z", features = ["fancy"] }
 ```
 
+Another way to display a diagnostic is by printing them using the debug formatter. 
+This is, in fact, what returning diagnostics from main ends up doing.
+To do it yourself, you can write the following:
+
+```rust
+use miette::{IntoDiagnostic, Result};
+use semver::Version;
+
+fn just_a_random_function() {
+    let version_result: Result<Version> = "1.2.x".parse().into_diagnostic();
+    match version_result {
+        Err(e) => println!("{:?}", e),
+        Ok(version) => println!("{}", version),
+    }
+}
+```
+
 #### ... diagnostic code URLs
 
 `miette` supports providing a URL for individual diagnostics. This URL will
diff --git a/src/lib.rs b/src/lib.rs
index 08de732..d80efa7 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -304,6 +304,23 @@
 //! miette = { version = "X.Y.Z", features = ["fancy"] }
 //! ```
 //!
+//! Another way to display a diagnostic is by printing them using the debug formatter.
+//! This is, in fact, what returning diagnostics from main ends up doing.
+//! To do it yourself, you can write the following:
+//!
+//! ```rust
+//! use miette::{IntoDiagnostic, Result};
+//! use semver::Version;
+//!
+//! fn just_a_random_function() {
+//!     let version_result: Result<Version> = "1.2.x".parse().into_diagnostic();
+//!     match version_result {
+//!         Err(e) => println!("{:?}", e),
+//!         Ok(version) => println!("{}", version),
+//!     }
+//! }
+//! ```
+//!
 //! ### ... diagnostic code URLs
 //!
 //! `miette` supports providing a URL for individual diagnostics. This URL will

From 865d67c8dda119ddd03ac43be22f4fa272a9f433 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jonathan=20D=C3=B6nszelmann?= <jonabent@gmail.com>
Date: Wed, 15 Nov 2023 19:39:29 +0100
Subject: [PATCH 22/67] feat(graphical): support rendering labels that contain
 newlines (#318)

Fixes: https://github.com/zkat/miette/issues/85
---
 src/handlers/graphical.rs | 313 ++++++++++++++++++++++++++++++++------
 tests/graphical.rs        | 171 +++++++++++++++++++++
 2 files changed, 435 insertions(+), 49 deletions(-)

diff --git a/src/handlers/graphical.rs b/src/handlers/graphical.rs
index 35e9c79..baadfb3 100644
--- a/src/handlers/graphical.rs
+++ b/src/handlers/graphical.rs
@@ -20,7 +20,7 @@ This printer can be customized by using [`new_themed()`](GraphicalReportHandler:
 
 See [`set_hook()`](crate::set_hook) for more details on customizing your global
 printer.
-*/
+ */
 #[derive(Debug, Clone)]
 pub struct GraphicalReportHandler {
     pub(crate) links: LinkStyle,
@@ -545,7 +545,13 @@ impl GraphicalReportHandler {
                 // no line number!
                 self.write_no_linum(f, linum_width)?;
                 // gutter _again_
-                self.render_highlight_gutter(f, max_gutter, line, &labels)?;
+                self.render_highlight_gutter(
+                    f,
+                    max_gutter,
+                    line,
+                    &labels,
+                    LabelRenderMode::SingleLine,
+                )?;
                 self.render_single_line_highlights(
                     f,
                     line,
@@ -557,11 +563,7 @@ impl GraphicalReportHandler {
             }
             for hl in multi_line {
                 if hl.label().is_some() && line.span_ends(hl) && !line.span_starts(hl) {
-                    // no line number!
-                    self.write_no_linum(f, linum_width)?;
-                    // gutter _again_
-                    self.render_highlight_gutter(f, max_gutter, line, &labels)?;
-                    self.render_multi_line_end(f, hl)?;
+                    self.render_multi_line_end(f, &labels, max_gutter, linum_width, line, hl)?;
                 }
             }
         }
@@ -575,6 +577,91 @@ impl GraphicalReportHandler {
         Ok(())
     }
 
+    fn render_multi_line_end(
+        &self,
+        f: &mut impl fmt::Write,
+        labels: &[FancySpan],
+        max_gutter: usize,
+        linum_width: usize,
+        line: &Line,
+        label: &FancySpan,
+    ) -> fmt::Result {
+        // no line number!
+        self.write_no_linum(f, linum_width)?;
+
+        if let Some(label_parts) = label.label_parts() {
+            // if it has a label, how long is it?
+            let (first, rest) = label_parts
+                .split_first()
+                .expect("cannot crash because rest would have been None, see docs on the `label` field of FancySpan");
+
+            if rest.is_empty() {
+                // gutter _again_
+                self.render_highlight_gutter(
+                    f,
+                    max_gutter,
+                    line,
+                    &labels,
+                    LabelRenderMode::SingleLine,
+                )?;
+
+                self.render_multi_line_end_single(
+                    f,
+                    first,
+                    label.style,
+                    LabelRenderMode::SingleLine,
+                )?;
+            } else {
+                // gutter _again_
+                self.render_highlight_gutter(
+                    f,
+                    max_gutter,
+                    line,
+                    &labels,
+                    LabelRenderMode::MultiLineFirst,
+                )?;
+
+                self.render_multi_line_end_single(
+                    f,
+                    first,
+                    label.style,
+                    LabelRenderMode::MultiLineFirst,
+                )?;
+                for label_line in rest {
+                    // no line number!
+                    self.write_no_linum(f, linum_width)?;
+                    // gutter _again_
+                    self.render_highlight_gutter(
+                        f,
+                        max_gutter,
+                        line,
+                        &labels,
+                        LabelRenderMode::MultiLineRest,
+                    )?;
+                    self.render_multi_line_end_single(
+                        f,
+                        label_line,
+                        label.style,
+                        LabelRenderMode::MultiLineRest,
+                    )?;
+                }
+            }
+        } else {
+            // gutter _again_
+            self.render_highlight_gutter(
+                f,
+                max_gutter,
+                line,
+                &labels,
+                LabelRenderMode::SingleLine,
+            )?;
+            // has no label
+            writeln!(f, "{}", self.theme.characters.hbar.style(label.style))?;
+        }
+
+        Ok(())
+    }
+
     fn render_line_gutter(
         &self,
         f: &mut impl fmt::Write,
@@ -643,6 +730,7 @@ impl GraphicalReportHandler {
         max_gutter: usize,
         line: &Line,
         highlights: &[FancySpan],
+        render_mode: LabelRenderMode,
     ) -> fmt::Result {
         if max_gutter == 0 {
             return Ok(());
@@ -652,15 +740,33 @@ impl GraphicalReportHandler {
         let applicable = highlights.iter().filter(|hl| line.span_applies(hl));
         for (i, hl) in applicable.enumerate() {
             if !line.span_line_only(hl) && line.span_ends(hl) {
-                gutter.push_str(&chars.lbot.style(hl.style).to_string());
-                gutter.push_str(
-                    &chars
-                        .hbar
-                        .to_string()
-                        .repeat(max_gutter.saturating_sub(i) + 2)
-                        .style(hl.style)
-                        .to_string(),
-                );
+                if render_mode == LabelRenderMode::MultiLineRest {
+                    // this is to make multiline labels work. We want to make the right amount
+                    // of horizontal space for them, but not actually draw the lines
+                    for _ in 0..max_gutter.saturating_sub(i) + 2 {
+                        gutter.push(' ');
+                    }
+                } else {
+                    gutter.push_str(&chars.lbot.style(hl.style).to_string());
+
+                    gutter.push_str(
+                        &chars
+                            .hbar
+                            .to_string()
+                            .repeat(
+                                max_gutter.saturating_sub(i)
+                                    // if we are rendering a multiline label, then leave a bit of space for the
+                                    // rcross character
+                                    + if render_mode == LabelRenderMode::MultiLineFirst {
+                                        1
+                                    } else {
+                                        2
+                                    },
+                            )
+                            .style(hl.style)
+                            .to_string(),
+                    );
+                }
                 break;
             } else {
                 gutter.push_str(&chars.vbar.style(hl.style).to_string());
@@ -811,27 +917,40 @@ impl GraphicalReportHandler {
         writeln!(f, "{}", underlines)?;
 
         for hl in single_liners.iter().rev() {
-            if let Some(label) = hl.label() {
-                self.write_no_linum(f, linum_width)?;
-                self.render_highlight_gutter(f, max_gutter, line, all_highlights)?;
-                let mut curr_offset = 1usize;
-                for (offset_hl, vbar_offset) in &vbar_offsets {
-                    while curr_offset < *vbar_offset + 1 {
-                        write!(f, " ")?;
-                        curr_offset += 1;
-                    }
-                    if *offset_hl != hl {
-                        write!(f, "{}", chars.vbar.to_string().style(offset_hl.style))?;
-                        curr_offset += 1;
-                    } else {
-                        let lines = format!(
-                            "{}{} {}",
-                            chars.lbot,
-                            chars.hbar.to_string().repeat(2),
-                            label,
-                        );
-                        writeln!(f, "{}", lines.style(hl.style))?;
-                        break;
+            if let Some(label) = hl.label_parts() {
+                if label.len() == 1 {
+                    self.write_label_text(
+                        f,
+                        line,
+                        linum_width,
+                        max_gutter,
+                        all_highlights,
+                        chars,
+                        &vbar_offsets,
+                        hl,
+                        &label[0],
+                        LabelRenderMode::SingleLine,
+                    )?;
+                } else {
+                    let mut first = true;
+                    for label_line in &label {
+                        self.write_label_text(
+                            f,
+                            line,
+                            linum_width,
+                            max_gutter,
+                            all_highlights,
+                            chars,
+                            &vbar_offsets,
+                            hl,
+                            label_line,
+                            if first {
+                                LabelRenderMode::MultiLineFirst
+                            } else {
+                                LabelRenderMode::MultiLineRest
+                            },
+                        )?;
+                        first = false;
                     }
                 }
             }
@@ -839,13 +958,80 @@ impl GraphicalReportHandler {
         Ok(())
     }
 
-    fn render_multi_line_end(&self, f: &mut impl fmt::Write, hl: &FancySpan) -> fmt::Result {
-        writeln!(
+    // I know it's not good practice, but making this a function makes a lot of sense
+    // and making a struct for this does not...
+    #[allow(clippy::too_many_arguments)]
+    fn write_label_text(
+        &self,
+        f: &mut impl fmt::Write,
+        line: &Line,
+        linum_width: usize,
+        max_gutter: usize,
+        all_highlights: &[FancySpan],
+        chars: &ThemeCharacters,
+        vbar_offsets: &[(&&FancySpan, usize)],
+        hl: &&FancySpan,
+        label: &str,
+        render_mode: LabelRenderMode,
+    ) -> fmt::Result {
+        self.write_no_linum(f, linum_width)?;
+        self.render_highlight_gutter(
             f,
-            "{} {}",
-            self.theme.characters.hbar.style(hl.style),
-            hl.label().unwrap_or_else(|| "".into()),
+            max_gutter,
+            line,
+            all_highlights,
+            LabelRenderMode::SingleLine,
         )?;
+        let mut curr_offset = 1usize;
+        for (offset_hl, vbar_offset) in vbar_offsets {
+            while curr_offset < *vbar_offset + 1 {
+                write!(f, " ")?;
+                curr_offset += 1;
+            }
+            if *offset_hl != hl {
+                write!(f, "{}", chars.vbar.to_string().style(offset_hl.style))?;
+                curr_offset += 1;
+            } else {
+                let lines = match render_mode {
+                    LabelRenderMode::SingleLine => format!(
+                        "{}{} {}",
+                        chars.lbot,
+                        chars.hbar.to_string().repeat(2),
+                        label,
+                    ),
+                    LabelRenderMode::MultiLineFirst => {
+                        format!("{}{}{} {}", chars.lbot, chars.hbar, chars.rcross, label,)
+                    }
+                    LabelRenderMode::MultiLineRest => {
+                        format!("  {} {}", chars.vbar, label,)
+                    }
+                };
+                writeln!(f, "{}", lines.style(hl.style))?;
+                break;
+            }
+        }
+        Ok(())
+    }
+
+    fn render_multi_line_end_single(
+        &self,
+        f: &mut impl fmt::Write,
+        label: &str,
+        style: Style,
+        render_mode: LabelRenderMode,
+    ) -> fmt::Result {
+        match render_mode {
+            LabelRenderMode::SingleLine => {
+                writeln!(f, "{} {}", self.theme.characters.hbar.style(style), label)?;
+            }
+            LabelRenderMode::MultiLineFirst => {
+                writeln!(f, "{} {}", self.theme.characters.rcross.style(style), label)?;
+            }
+            LabelRenderMode::MultiLineRest => {
+                writeln!(f, "{} {}", self.theme.characters.vbar.style(style), label)?;
+            }
+        }
+
         Ok(())
     }
 
@@ -924,6 +1110,16 @@ impl ReportHandler for GraphicalReportHandler {
 Support types
 */
 
+#[derive(PartialEq, Debug)]
+enum LabelRenderMode {
+    /// we're rendering a single line label (or not rendering in any special way)
+    SingleLine,
+    /// we're rendering a multiline label
+    MultiLineFirst,
+    /// we're rendering the rest of a multiline label
+    MultiLineRest,
+}
+
 #[derive(Debug)]
 struct Line {
     line_number: usize,
@@ -941,10 +1137,10 @@ impl Line {
         let spanlen = if span.len() == 0 { 1 } else { span.len() };
         // Span starts in this line
         (span.offset() >= self.offset && span.offset() < self.offset + self.length)
-        // Span passes through this line
-        || (span.offset() < self.offset && span.offset() + spanlen > self.offset + self.length) //todo
-        // Span ends on this line
-        || (span.offset() + spanlen > self.offset && span.offset() + spanlen <= self.offset + self.length)
+            // Span passes through this line
+            || (span.offset() < self.offset && span.offset() + spanlen > self.offset + self.length) //todo
+            // Span ends on this line
+            || (span.offset() + spanlen > self.offset && span.offset() + spanlen <= self.offset + self.length)
     }
 
     // A 'flyby' is a multi-line span that technically covers this line, but
@@ -974,7 +1170,10 @@ impl Line {
 
 #[derive(Debug, Clone)]
 struct FancySpan {
-    label: Option<String>,
+    /// this is deliberately an option of a vec because I wanted to be very explicit
+    /// that there can also be *no* label. If there is a label, it can have multiple
+    /// lines which is what the vec is for.
+    label: Option<Vec<String>>,
     span: SourceSpan,
     style: Style,
 }
@@ -985,9 +1184,17 @@ impl PartialEq for FancySpan {
     }
 }
 
+fn split_label(v: String) -> Vec<String> {
+    v.split('\n').map(|i| i.to_string()).collect()
+}
+
 impl FancySpan {
     fn new(label: Option<String>, span: SourceSpan, style: Style) -> Self {
-        FancySpan { label, span, style }
+        FancySpan {
+            label: label.map(split_label),
+            span,
+            style,
+        }
     }
 
     fn style(&self) -> Style {
@@ -997,7 +1204,15 @@ impl FancySpan {
     fn label(&self) -> Option<String> {
         self.label
             .as_ref()
-            .map(|l| l.style(self.style()).to_string())
+            .map(|l| l.join("\n").style(self.style()).to_string())
+    }
+
+    fn label_parts(&self) -> Option<Vec<String>> {
+        self.label.as_ref().map(|l| {
+            l.iter()
+                .map(|i| i.style(self.style()).to_string())
+                .collect()
+        })
     }
 
     fn offset(&self) -> usize {
diff --git a/tests/graphical.rs b/tests/graphical.rs
index 536efcd..f59f849 100644
--- a/tests/graphical.rs
+++ b/tests/graphical.rs
@@ -251,6 +251,52 @@ fn empty_source() -> Result<(), MietteError> {
     Ok(())
 }
 
+#[test]
+fn multiple_spans_multiline() {
+    #[derive(Error, Debug, Diagnostic)]
+    #[error("oops!")]
+    #[diagnostic(severity(Error))]
+    struct MyBad {
+        #[source_code]
+        src: NamedSource,
+        #[label("big")]
+        big: SourceSpan,
+        #[label("small")]
+        small: SourceSpan,
+    }
+    let err = MyBad {
+        src: NamedSource::new(
+            "issue",
+            "\
+if true {
+    a
+} else {
+    b
+}",
+        ),
+        big: (0, 32).into(),
+        small: (14, 1).into(),
+    };
+    let out = fmt_report(err.into());
+    println!("Error: {}", out);
+
+    let expected = r#"  × oops!
+   ╭─[issue:1:1]
+ 1 │ ╭─▶ if true {
+ 2 │ │╭▶     a
+   · ││    ┬
+   · ││    ╰── small
+ 3 │ │   } else {
+ 4 │ │       b
+ 5 │ ├─▶ }
+   · ╰──── big
+   ╰────
+"#
+    .to_string();
+
+    assert_eq!(expected, out);
+}
+
 #[test]
 fn single_line_highlight_span_full_line() {
     #[derive(Error, Debug, Diagnostic)]
@@ -725,6 +771,94 @@ fn single_line_highlight_at_line_start() -> Result<(), MietteError> {
     Ok(())
 }
 
+#[test]
+fn multiline_label() -> Result<(), MietteError> {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("oops!")]
+    #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
+    struct MyBad {
+        #[source_code]
+        src: NamedSource,
+        #[label("this bit here\nand\nthis\ntoo")]
+        highlight: SourceSpan,
+    }
+
+    let src = "source\ntext\n  here".to_string();
+    let err = MyBad {
+        src: NamedSource::new("bad_file.rs", src),
+        highlight: (7, 4).into(),
+    };
+    let out = fmt_report(err.into());
+    println!("Error: {}", out);
+    let expected = r#"oops::my::bad
+
+  × oops!
+   ╭─[bad_file.rs:2:1]
+ 1 │ source
+ 2 │ text
+   · ──┬─
+   ·   ╰─┤ this bit here
+   ·     │ and
+   ·     │ this
+   ·     │ too
+ 3 │   here
+   ╰────
+  help: try doing it better next time?
+"#
+    .trim_start()
+    .to_string();
+    assert_eq!(expected, out);
+    Ok(())
+}
+
+#[test]
+fn multiple_multi_line_labels() -> Result<(), MietteError> {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("oops!")]
+    #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
+    struct MyBad {
+        #[source_code]
+        src: NamedSource,
+        #[label = "x\ny"]
+        highlight1: SourceSpan,
+        #[label = "z\nw"]
+        highlight2: SourceSpan,
+        #[label = "a\nb"]
+        highlight3: SourceSpan,
+    }
+
+    let src = "source\n  text text text text text\n    here".to_string();
+    let err = MyBad {
+        src: NamedSource::new("bad_file.rs", src),
+        highlight1: (9, 4).into(),
+        highlight2: (14, 4).into(),
+        highlight3: (24, 4).into(),
+    };
+    let out = fmt_report(err.into());
+    println!("Error: {}", out);
+    let expected = r#"oops::my::bad
+
+  × oops!
+   ╭─[bad_file.rs:2:3]
+ 1 │ source
+ 2 │   text text text text text
+   ·   ──┬─ ──┬─      ──┬─
+   ·     │    │         ╰─┤ a
+   ·     │    │           │ b
+   ·     │    ╰─┤ z
+   ·     │      │ w
+   ·     ╰─┤ x
+   ·       │ y
+ 3 │     here
+   ╰────
+  help: try doing it better next time?
+"#
+    .trim_start()
+    .to_string();
+    assert_eq!(expected, out);
+    Ok(())
+}
+
 #[test]
 fn multiple_same_line_highlights() -> Result<(), MietteError> {
     #[derive(Debug, Diagnostic, Error)]
@@ -853,6 +987,43 @@ fn multiline_highlight_adjacent() -> Result<(), MietteError> {
     Ok(())
 }
 
+#[test]
+fn multiline_highlight_multiline_label() -> Result<(), MietteError> {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("oops!")]
+    #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
+    struct MyBad {
+        #[source_code]
+        src: NamedSource,
+        #[label = "these two lines\nare the problem"]
+        highlight: SourceSpan,
+    }
+
+    let src = "source\n  text\n    here".to_string();
+    let err = MyBad {
+        src: NamedSource::new("bad_file.rs", src),
+        highlight: (9, 11).into(),
+    };
+    let out = fmt_report(err.into());
+    println!("Error: {}", out);
+    let expected = r#"oops::my::bad
+
+  × oops!
+   ╭─[bad_file.rs:2:3]
+ 1 │     source
+ 2 │ ╭─▶   text
+ 3 │ ├─▶     here
+   · ╰──┤ these two lines
+   ·    │ are the problem
+   ╰────
+  help: try doing it better next time?
+"#
+    .trim_start()
+    .to_string();
+    assert_eq!(expected, out);
+    Ok(())
+}
+
 #[test]
 fn multiline_highlight_flyby() -> Result<(), MietteError> {
     #[derive(Debug, Diagnostic, Error)]

From 7ff4f874d693a665af4df40f4e94505013e3e262 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jonathan=20D=C3=B6nszelmann?= <jonabent@gmail.com>
Date: Wed, 15 Nov 2023 20:40:16 +0100
Subject: [PATCH 23/67] fix(graphical): rendering bug on small spans in large
 spans (#316)

Fixes: https://github.com/zkat/miette/issues/317

It turned out there were two really. One related to how many characters
were added for the arrowheads in the gutter, and one where the gutter
was extended to a number of characters, including ansi escape codes.
However, because ansi escape codes are rather big, there would never be
any extension since the system thought the string was already long
enough, even though you don't actually see the width of those codes.
---
 src/handlers/graphical.rs | 69 ++++++++++++++++++++++++++++++++++-----
 tests/graphical.rs        |  6 ++--
 2 files changed, 63 insertions(+), 12 deletions(-)

diff --git a/src/handlers/graphical.rs b/src/handlers/graphical.rs
index baadfb3..3193472 100644
--- a/src/handlers/graphical.rs
+++ b/src/handlers/graphical.rs
@@ -20,7 +20,7 @@ This printer can be customized by using [`new_themed()`](GraphicalReportHandler:
 
 See [`set_hook()`](crate::set_hook) for more details on customizing your global
 printer.
- */
+*/
 #[derive(Debug, Clone)]
 pub struct GraphicalReportHandler {
     pub(crate) links: LinkStyle,
@@ -468,7 +468,7 @@ impl GraphicalReportHandler {
         for line in &lines {
             let mut num_highlights = 0;
             for hl in &labels {
-                if !line.span_line_only(hl) && line.span_applies(hl) {
+                if !line.span_line_only(hl) && line.span_applies_gutter(hl) {
                     num_highlights += 1;
                 }
             }
@@ -674,7 +674,7 @@ impl GraphicalReportHandler {
         }
         let chars = &self.theme.characters;
         let mut gutter = String::new();
-        let applicable = highlights.iter().filter(|hl| line.span_applies(hl));
+        let applicable = highlights.iter().filter(|hl| line.span_applies_gutter(hl));
         let mut arrow = false;
         for (i, hl) in applicable.enumerate() {
             if line.span_starts(hl) {
@@ -735,18 +735,35 @@ impl GraphicalReportHandler {
         if max_gutter == 0 {
             return Ok(());
         }
+
+        // keeps track of how many colums wide the gutter is
+        // important for ansi since simply measuring the size of the final string
+        // gives the wrong result when the string contains ansi codes.
+        let mut gutter_cols = 0;
+
         let chars = &self.theme.characters;
         let mut gutter = String::new();
-        let applicable = highlights.iter().filter(|hl| line.span_applies(hl));
+        let applicable = highlights.iter().filter(|hl| line.span_applies_gutter(hl));
         for (i, hl) in applicable.enumerate() {
             if !line.span_line_only(hl) && line.span_ends(hl) {
                 if render_mode == LabelRenderMode::MultiLineRest {
                     // this is to make multiline labels work. We want to make the right amount
                     // of horizontal space for them, but not actually draw the lines
-                    for _ in 0..max_gutter.saturating_sub(i) + 2 {
+                    let horizontal_space = max_gutter.saturating_sub(i) + 2;
+                    for _ in 0..horizontal_space {
                         gutter.push(' ');
                     }
+                    // account for one more horizontal space, since in multiline mode
+                    // we also add in the vertical line before the label like this:
+                    // 2 │ ╭─▶   text
+                    // 3 │ ├─▶     here
+                    //   · ╰──┤ these two lines
+                    //   ·    │ are the problem
+                    //        ^this
+                    gutter_cols += horizontal_space + 1;
                 } else {
+                    let num_repeat = max_gutter.saturating_sub(i) + 2;
+
                     gutter.push_str(&chars.lbot.style(hl.style).to_string());
 
                     gutter.push_str(
@@ -754,25 +771,42 @@ impl GraphicalReportHandler {
                             .hbar
                             .to_string()
                             .repeat(
-                                max_gutter.saturating_sub(i)
+                                num_repeat
                                     // if we are rendering a multiline label, then leave a bit of space for the
                                     // rcross character
-                                    + if render_mode == LabelRenderMode::MultiLineFirst {
+                                    - if render_mode == LabelRenderMode::MultiLineFirst {
                                         1
                                     } else {
-                                        2
+                                        0
                                     },
                             )
                             .style(hl.style)
                             .to_string(),
                     );
+
+                    // we count 1 for the lbot char, and then a few more, the same number
+                    // as we just repeated for. For each repeat we only add 1, even though
+                    // due to ansi escape codes the number of bytes in the string could grow
+                    // a lot each time.
+                    gutter_cols += num_repeat + 1;
                 }
                 break;
             } else {
                 gutter.push_str(&chars.vbar.style(hl.style).to_string());
+
+                // we may push many bytes for the ansi escape codes style adds,
+                // but we still only add a single character-width to the string in a terminal
+                gutter_cols += 1;
             }
         }
-        write!(f, "{:width$}", gutter, width = max_gutter + 1)?;
+
+        // now calculate how many spaces to add based on how many columns we just created.
+        // it's the max width of the gutter, minus how many character-widths we just generated
+        // capped at 0 (though this should never go below in reality), and then we add 3 to
+        // account for arrowheads when a gutter line ends
+        let num_spaces = (max_gutter + 3).saturating_sub(gutter_cols);
+        // we then write the gutter and as many spaces as we need
+        write!(f, "{}{:width$}", gutter, "", width = num_spaces)?;
         Ok(())
     }
 
@@ -1133,9 +1167,12 @@ impl Line {
         span.offset() >= self.offset && span.offset() + span.len() <= self.offset + self.length
     }
 
+    /// Returns whether `span` should be visible on this line, either in the gutter or under the
+    /// text on this line
     fn span_applies(&self, span: &FancySpan) -> bool {
         let spanlen = if span.len() == 0 { 1 } else { span.len() };
         // Span starts in this line
+
         (span.offset() >= self.offset && span.offset() < self.offset + self.length)
             // Span passes through this line
             || (span.offset() < self.offset && span.offset() + spanlen > self.offset + self.length) //todo
@@ -1143,6 +1180,20 @@ impl Line {
             || (span.offset() + spanlen > self.offset && span.offset() + spanlen <= self.offset + self.length)
     }
 
+    /// Returns whether `span` should be visible on this line in the gutter (so this excludes spans
+    /// that are only visible on this line and do not span multiple lines)
+    fn span_applies_gutter(&self, span: &FancySpan) -> bool {
+        let spanlen = if span.len() == 0 { 1 } else { span.len() };
+        // Span starts in this line
+        self.span_applies(span)
+            && !(
+                // as long as it doesn't start *and* end on this line
+                (span.offset() >= self.offset && span.offset() < self.offset + self.length)
+                    && (span.offset() + spanlen > self.offset
+                        && span.offset() + spanlen <= self.offset + self.length)
+            )
+    }
+
     // A 'flyby' is a multi-line span that technically covers this line, but
     // does not begin or end within the line itself. This method is used to
     // calculate gutters.
diff --git a/tests/graphical.rs b/tests/graphical.rs
index f59f849..aabf167 100644
--- a/tests/graphical.rs
+++ b/tests/graphical.rs
@@ -283,9 +283,9 @@ if true {
     let expected = r#"  × oops!
    ╭─[issue:1:1]
  1 │ ╭─▶ if true {
- 2 │ │╭▶     a
-   · ││    ┬
-   · ││    ╰── small
+ 2 │ │       a
+   · │       ┬
+   · │       ╰── small
  3 │ │   } else {
  4 │ │       b
  5 │ ├─▶ }

From b0744462adbbfbb6d845f382db36be883c7f3c45 Mon Sep 17 00:00:00 2001
From: Zanie Blue <contact@zanie.dev>
Date: Thu, 4 Jan 2024 12:44:52 -0600
Subject: [PATCH 24/67] feat(graphical): Add `wrap_lines: bool` option allowing
 wrapping be disabled entirely (#328)

---
 src/handler.rs            | 15 ++++++++++-
 src/handlers/graphical.rs | 54 +++++++++++++++++++++++++++++++++++----
 tests/graphical.rs        | 44 +++++++++++++++++++++++++++++++
 3 files changed, 107 insertions(+), 6 deletions(-)

diff --git a/src/handler.rs b/src/handler.rs
index e32f3ef..38c9fc8 100644
--- a/src/handler.rs
+++ b/src/handler.rs
@@ -56,6 +56,7 @@ pub struct MietteHandlerOpts {
     pub(crate) tab_width: Option<usize>,
     pub(crate) with_cause_chain: Option<bool>,
     pub(crate) break_words: Option<bool>,
+    pub(crate) wrap_lines: Option<bool>,
     pub(crate) word_separator: Option<textwrap::WordSeparator>,
     pub(crate) word_splitter: Option<textwrap::WordSplitter>,
 }
@@ -89,6 +90,16 @@ impl MietteHandlerOpts {
         self
     }
 
+    /// If true, long lines can be wrapped.
+    ///
+    /// If false, long lines will not be broken when they exceed the width.
+    ///
+    /// Defaults to true.
+    pub fn wrap_lines(mut self, wrap_lines: bool) -> Self {
+        self.wrap_lines = Some(wrap_lines);
+        self
+    }
+
     /// If true, long words can be broken when wrapping.
     ///
     /// If false, long words will not be broken when they exceed the width.
@@ -98,7 +109,6 @@ impl MietteHandlerOpts {
         self.break_words = Some(break_words);
         self
     }
-
     /// Sets the `textwrap::WordSeparator` to use when determining wrap points.
     pub fn word_separator(mut self, word_separator: textwrap::WordSeparator) -> Self {
         self.word_separator = Some(word_separator);
@@ -260,6 +270,9 @@ impl MietteHandlerOpts {
             if let Some(b) = self.break_words {
                 handler = handler.with_break_words(b)
             }
+            if let Some(b) = self.wrap_lines {
+                handler = handler.with_wrap_lines(b)
+            }
             if let Some(s) = self.word_separator {
                 handler = handler.with_word_separator(s)
             }
diff --git a/src/handlers/graphical.rs b/src/handlers/graphical.rs
index 3193472..951303a 100644
--- a/src/handlers/graphical.rs
+++ b/src/handlers/graphical.rs
@@ -30,6 +30,7 @@ pub struct GraphicalReportHandler {
     pub(crate) context_lines: usize,
     pub(crate) tab_width: usize,
     pub(crate) with_cause_chain: bool,
+    pub(crate) wrap_lines: bool,
     pub(crate) break_words: bool,
     pub(crate) word_separator: Option<textwrap::WordSeparator>,
     pub(crate) word_splitter: Option<textwrap::WordSplitter>,
@@ -54,6 +55,7 @@ impl GraphicalReportHandler {
             context_lines: 1,
             tab_width: 4,
             with_cause_chain: true,
+            wrap_lines: true,
             break_words: true,
             word_separator: None,
             word_splitter: None,
@@ -69,6 +71,7 @@ impl GraphicalReportHandler {
             footer: None,
             context_lines: 1,
             tab_width: 4,
+            wrap_lines: true,
             with_cause_chain: true,
             break_words: true,
             word_separator: None,
@@ -131,6 +134,12 @@ impl GraphicalReportHandler {
         self
     }
 
+    /// Enables or disables wrapping of lines to fit the width.
+    pub fn with_wrap_lines(mut self, wrap_lines: bool) -> Self {
+        self.wrap_lines = wrap_lines;
+        self
+    }
+
     /// Enables or disables breaking of words during wrapping.
     pub fn with_break_words(mut self, break_words: bool) -> Self {
         self.break_words = break_words;
@@ -197,7 +206,7 @@ impl GraphicalReportHandler {
                 opts = opts.word_splitter(word_splitter);
             }
 
-            writeln!(f, "{}", textwrap::fill(footer, opts))?;
+            writeln!(f, "{}", self.wrap(footer, opts))?;
         }
         Ok(())
     }
@@ -258,7 +267,7 @@ impl GraphicalReportHandler {
             opts = opts.word_splitter(word_splitter);
         }
 
-        writeln!(f, "{}", textwrap::fill(&diagnostic.to_string(), opts))?;
+        writeln!(f, "{}", self.wrap(&diagnostic.to_string(), opts))?;
 
         if !self.with_cause_chain {
             return Ok(());
@@ -314,10 +323,10 @@ impl GraphicalReportHandler {
                         inner_renderer.with_cause_chain = false;
                         inner_renderer.render_report(&mut inner, diag)?;
 
-                        writeln!(f, "{}", textwrap::fill(&inner, opts))?;
+                        writeln!(f, "{}", self.wrap(&inner, opts))?;
                     }
                     ErrorKind::StdError(err) => {
-                        writeln!(f, "{}", textwrap::fill(&err.to_string(), opts))?;
+                        writeln!(f, "{}", self.wrap(&err.to_string(), opts))?;
                     }
                 }
             }
@@ -341,7 +350,7 @@ impl GraphicalReportHandler {
                 opts = opts.word_splitter(word_splitter);
             }
 
-            writeln!(f, "{}", textwrap::fill(&help.to_string(), opts))?;
+            writeln!(f, "{}", self.wrap(&help.to_string(), opts))?;
         }
         Ok(())
     }
@@ -810,6 +819,41 @@ impl GraphicalReportHandler {
         Ok(())
     }
 
+    fn wrap(&self, text: &str, opts: textwrap::Options<'_>) -> String {
+        if self.wrap_lines {
+            textwrap::fill(text, opts)
+        } else {
+            // Format without wrapping, but retain the indentation options
+            // Implementation based on `textwrap::indent`
+            let mut result = String::with_capacity(2 * text.len());
+            let trimmed_indent = opts.subsequent_indent.trim_end();
+            for (idx, line) in text.split_terminator('\n').enumerate() {
+                if idx > 0 {
+                    result.push('\n');
+                }
+                if idx == 0 {
+                    if line.trim().is_empty() {
+                        result.push_str(opts.initial_indent.trim_end());
+                    } else {
+                        result.push_str(opts.initial_indent);
+                    }
+                } else {
+                    if line.trim().is_empty() {
+                        result.push_str(trimmed_indent);
+                    } else {
+                        result.push_str(opts.subsequent_indent);
+                    }
+                }
+                result.push_str(line);
+            }
+            if text.ends_with('\n') {
+                // split_terminator will have eaten the final '\n'.
+                result.push('\n');
+            }
+            result
+        }
+    }
+
     fn write_linum(&self, f: &mut impl fmt::Write, width: usize, linum: usize) -> fmt::Result {
         write!(
             f,
diff --git a/tests/graphical.rs b/tests/graphical.rs
index aabf167..21185f5 100644
--- a/tests/graphical.rs
+++ b/tests/graphical.rs
@@ -218,6 +218,50 @@ fn word_wrap_options() -> Result<(), MietteError> {
     Ok(())
 }
 
+#[test]
+fn wrap_option() -> Result<(), MietteError> {
+    // A line should break on the width
+    let out = fmt_report_with_settings(
+        Report::msg("abc def ghi jkl mno pqr stu vwx yz abc def ghi jkl mno pqr stu vwx yz"),
+        |handler| handler.with_width(15),
+    );
+    let expected = r#"  × abc def
+  │ ghi jkl
+  │ mno pqr
+  │ stu vwx
+  │ yz abc
+  │ def ghi
+  │ jkl mno
+  │ pqr stu
+  │ vwx yz
+"#
+    .to_string();
+    assert_eq!(expected, out);
+
+    // Unless, wrapping is disabled
+    let out = fmt_report_with_settings(
+        Report::msg("abc def ghi jkl mno pqr stu vwx yz abc def ghi jkl mno pqr stu vwx yz"),
+        |handler| handler.with_width(15).with_wrap_lines(false),
+    );
+    let expected =
+        "  × abc def ghi jkl mno pqr stu vwx yz abc def ghi jkl mno pqr stu vwx yz\n".to_string();
+    assert_eq!(expected, out);
+
+    // Then, user-defined new lines should be preserved wrapping is disabled
+    let out = fmt_report_with_settings(
+      Report::msg("abc def ghi jkl mno pqr stu vwx yz\nabc def ghi jkl mno pqr stu vwx yz\nabc def ghi jkl mno pqr stu vwx yz"),
+      |handler| handler.with_width(15).with_wrap_lines(false),
+  );
+    let expected = r#"  × abc def ghi jkl mno pqr stu vwx yz
+  │ abc def ghi jkl mno pqr stu vwx yz
+  │ abc def ghi jkl mno pqr stu vwx yz
+"#
+    .to_string();
+    assert_eq!(expected, out);
+
+    Ok(())
+}
+
 #[test]
 fn empty_source() -> Result<(), MietteError> {
     #[derive(Debug, Diagnostic, Error)]

From 19c22143cb544616046784e35c5e78cc5b881289 Mon Sep 17 00:00:00 2001
From: Hytak <lhc.holten@gmail.com>
Date: Thu, 11 Jan 2024 19:42:32 +0100
Subject: [PATCH 25/67] feat(graphical): render disjoint snippets separately
 for cleaner output (#324)

---
 src/handlers/graphical.rs | 120 +++++++++++++++++++-------------------
 tests/graphical.rs        |  92 +++++++++++++++++++++++++++++
 2 files changed, 151 insertions(+), 61 deletions(-)

diff --git a/src/handlers/graphical.rs b/src/handlers/graphical.rs
index 951303a..021ba34 100644
--- a/src/handlers/graphical.rs
+++ b/src/handlers/graphical.rs
@@ -6,7 +6,7 @@ use unicode_width::UnicodeWidthChar;
 use crate::diagnostic_chain::{DiagnosticChain, ErrorKind};
 use crate::handlers::theme::*;
 use crate::protocol::{Diagnostic, Severity};
-use crate::{LabeledSpan, MietteError, ReportHandler, SourceCode, SourceSpan, SpanContents};
+use crate::{LabeledSpan, ReportHandler, SourceCode, SourceSpan, SpanContents};
 
 /**
 A [`ReportHandler`] that displays a given [`Report`](crate::Report) in a
@@ -386,66 +386,58 @@ impl GraphicalReportHandler {
         diagnostic: &(dyn Diagnostic),
         opt_source: Option<&dyn SourceCode>,
     ) -> fmt::Result {
-        if let Some(source) = opt_source {
-            if let Some(labels) = diagnostic.labels() {
-                let mut labels = labels.collect::<Vec<_>>();
-                labels.sort_unstable_by_key(|l| l.inner().offset());
-                if !labels.is_empty() {
-                    let contents = labels
-                        .iter()
-                        .map(|label| {
-                            source.read_span(label.inner(), self.context_lines, self.context_lines)
-                        })
-                        .collect::<Result<Vec<Box<dyn SpanContents<'_>>>, MietteError>>()
-                        .map_err(|_| fmt::Error)?;
-                    let mut contexts = Vec::with_capacity(contents.len());
-                    for (right, right_conts) in labels.iter().cloned().zip(contents.iter()) {
-                        if contexts.is_empty() {
-                            contexts.push((right, right_conts));
-                        } else {
-                            let (left, left_conts) = contexts.last().unwrap().clone();
-                            let left_end = left.offset() + left.len();
-                            let right_end = right.offset() + right.len();
-                            if left_conts.line() + left_conts.line_count() >= right_conts.line() {
-                                // The snippets will overlap, so we create one Big Chunky Boi
-                                let new_span = LabeledSpan::new(
-                                    left.label().map(String::from),
-                                    left.offset(),
-                                    if right_end >= left_end {
-                                        // Right end goes past left end
-                                        right_end - left.offset()
-                                    } else {
-                                        // right is contained inside left
-                                        left.len()
-                                    },
-                                );
-                                if source
-                                    .read_span(
-                                        new_span.inner(),
-                                        self.context_lines,
-                                        self.context_lines,
-                                    )
-                                    .is_ok()
-                                {
-                                    contexts.pop();
-                                    contexts.push((
-                                        // We'll throw this away later
-                                        new_span, left_conts,
-                                    ));
-                                } else {
-                                    contexts.push((right, right_conts));
-                                }
-                            } else {
-                                contexts.push((right, right_conts));
-                            }
-                        }
-                    }
-                    for (ctx, _) in contexts {
-                        self.render_context(f, source, &ctx, &labels[..])?;
-                    }
+        let source = match opt_source {
+            Some(source) => source,
+            None => return Ok(()),
+        };
+        let labels = match diagnostic.labels() {
+            Some(labels) => labels,
+            None => return Ok(()),
+        };
+
+        let mut labels = labels.collect::<Vec<_>>();
+        labels.sort_unstable_by_key(|l| l.inner().offset());
+
+        let mut contexts = Vec::with_capacity(labels.len());
+        for right in labels.iter().cloned() {
+            let right_conts = source
+                .read_span(right.inner(), self.context_lines, self.context_lines)
+                .map_err(|_| fmt::Error)?;
+
+            if contexts.is_empty() {
+                contexts.push((right, right_conts));
+                continue;
+            }
+
+            let (left, left_conts) = contexts.last().unwrap();
+            if left_conts.line() + left_conts.line_count() >= right_conts.line() {
+                // The snippets will overlap, so we create one Big Chunky Boi
+                let left_end = left.offset() + left.len();
+                let right_end = right.offset() + right.len();
+                let new_end = std::cmp::max(left_end, right_end);
+
+                let new_span = LabeledSpan::new(
+                    left.label().map(String::from),
+                    left.offset(),
+                    new_end - left.offset(),
+                );
+                // Check that the two contexts can be combined
+                if let Ok(new_conts) =
+                    source.read_span(new_span.inner(), self.context_lines, self.context_lines)
+                {
+                    contexts.pop();
+                    // We'll throw the contents away later
+                    contexts.push((new_span, new_conts));
+                    continue;
                 }
             }
+
+            contexts.push((right, right_conts));
         }
+        for (ctx, _) in contexts {
+            self.render_context(f, source, &ctx, &labels[..])?;
+        }
+
         Ok(())
     }
 
@@ -458,10 +450,16 @@ impl GraphicalReportHandler {
     ) -> fmt::Result {
         let (contents, lines) = self.get_lines(source, context.inner())?;
 
-        let primary_label = labels
-            .iter()
+        // only consider labels from the context as primary label
+        let ctx_labels = labels.iter().filter(|l| {
+            context.inner().offset() <= l.inner().offset()
+                && l.inner().offset() + l.inner().len()
+                    <= context.inner().offset() + context.inner().len()
+        });
+        let primary_label = ctx_labels
+            .clone()
             .find(|label| label.primary())
-            .or_else(|| labels.first());
+            .or_else(|| ctx_labels.clone().next());
 
         // sorting is your friend
         let labels = labels
diff --git a/tests/graphical.rs b/tests/graphical.rs
index 21185f5..4e8b737 100644
--- a/tests/graphical.rs
+++ b/tests/graphical.rs
@@ -1757,3 +1757,95 @@ fn single_line_with_wide_char_unaligned_span_empty() -> Result<(), MietteError>
     assert_eq!(expected, out);
     Ok(())
 }
+
+#[test]
+fn triple_adjacent_highlight() -> Result<(), MietteError> {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("oops!")]
+    #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
+    struct MyBad {
+        #[source_code]
+        src: NamedSource,
+        #[label = "this bit here"]
+        highlight1: SourceSpan,
+        #[label = "also this bit"]
+        highlight2: SourceSpan,
+        #[label = "finally we got"]
+        highlight3: SourceSpan,
+    }
+
+    let src = "source\n\n\n  text\n\n\n    here".to_string();
+    let err = MyBad {
+        src: NamedSource::new("bad_file.rs", src),
+        highlight1: (0, 6).into(),
+        highlight2: (11, 4).into(),
+        highlight3: (22, 4).into(),
+    };
+    let out = fmt_report(err.into());
+    println!("Error: {}", out);
+    let expected = "oops::my::bad
+
+  × oops!
+   ╭─[bad_file.rs:1:1]
+ 1 │ source
+   · ───┬──
+   ·    ╰── this bit here
+ 2 │ 
+ 3 │ 
+ 4 │   text
+   ·   ──┬─
+   ·     ╰── also this bit
+ 5 │ 
+ 6 │ 
+ 7 │     here
+   ·     ──┬─
+   ·       ╰── finally we got
+   ╰────
+  help: try doing it better next time?
+";
+    assert_eq!(expected, &out);
+    Ok(())
+}
+
+#[test]
+fn non_adjacent_highlight() -> Result<(), MietteError> {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("oops!")]
+    #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
+    struct MyBad {
+        #[source_code]
+        src: NamedSource,
+        #[label = "this bit here"]
+        highlight1: SourceSpan,
+        #[label = "also this bit"]
+        highlight2: SourceSpan,
+    }
+
+    let src = "source\n\n\n\n  text    here".to_string();
+    let err = MyBad {
+        src: NamedSource::new("bad_file.rs", src),
+        highlight1: (0, 6).into(),
+        highlight2: (12, 4).into(),
+    };
+    let out = fmt_report(err.into());
+    println!("Error: {}", out);
+    let expected = "oops::my::bad
+
+  × oops!
+   ╭─[bad_file.rs:1:1]
+ 1 │ source
+   · ───┬──
+   ·    ╰── this bit here
+ 2 │ 
+   ╰────
+   ╭─[bad_file.rs:5:3]
+ 4 │ 
+ 5 │   text    here
+   ·   ──┬─
+   ·     ╰── also this bit
+   ╰────
+  help: try doing it better next time?
+";
+    assert_eq!(expected, &out);
+    Ok(())
+}

From 55bfc4201638e412dd2732d394389e22a7398822 Mon Sep 17 00:00:00 2001
From: Benjamin Lee <benjamin@computer.surgery>
Date: Thu, 11 Jan 2024 14:13:00 -0800
Subject: [PATCH 26/67] tests: improve robustness of color_format tests (#329)

Previously, these tests would have spurious failures when NO_COLOR or
FORCE_COLOR was set in the user's environment, since we weren't clearing
one variable before testing a value for the other one. The previous
version of the code also did not restore environment variable values on
panic, which could cause spurious failures in other tests after one test
fails.
---
 tests/color_format.rs | 73 +++++++++++++++++++++++++++++--------------
 1 file changed, 49 insertions(+), 24 deletions(-)

diff --git a/tests/color_format.rs b/tests/color_format.rs
index bb90708..95d40e0 100644
--- a/tests/color_format.rs
+++ b/tests/color_format.rs
@@ -3,6 +3,7 @@
 use lazy_static::lazy_static;
 use miette::{Diagnostic, MietteHandler, MietteHandlerOpts, ReportHandler, RgbColors};
 use regex::Regex;
+use std::ffi::OsString;
 use std::fmt::{self, Debug};
 use std::sync::Mutex;
 use thiserror::Error;
@@ -42,16 +43,29 @@ fn color_format(handler: MietteHandler) -> ColorFormat {
     }
 }
 
-/// Runs a function with an environment variable set to a specific value, then
-/// sets it back to it's original value once completed.
-fn with_env_var<F: FnOnce()>(var: &str, value: &str, body: F) {
-    let old_value = std::env::var_os(var);
-    std::env::set_var(var, value);
-    body();
-    if let Some(old_value) = old_value {
-        std::env::set_var(var, old_value);
-    } else {
-        std::env::remove_var(var);
+/// Store the current value of an environment variable on construction, and then
+/// restore that value when the guard is dropped.
+struct EnvVarGuard<'a> {
+    var: &'a str,
+    old_value: Option<OsString>,
+}
+
+impl EnvVarGuard<'_> {
+    fn new(var: &str) -> EnvVarGuard<'_> {
+        EnvVarGuard {
+            var,
+            old_value: std::env::var_os(var),
+        }
+    }
+}
+
+impl Drop for EnvVarGuard<'_> {
+    fn drop(&mut self) {
+        if let Some(old_value) = &self.old_value {
+            std::env::set_var(self.var, old_value);
+        } else {
+            std::env::remove_var(self.var);
+        }
     }
 }
 
@@ -72,22 +86,33 @@ fn check_colors<F: Fn(MietteHandlerOpts) -> MietteHandlerOpts>(
     //
     // Since environment variables are shared for the entire process, we need
     // to ensure that only one test that modifies these env vars runs at a time.
-    let guard = COLOR_ENV_VARS.lock().unwrap();
+    let lock = COLOR_ENV_VARS.lock().unwrap();
 
-    with_env_var("NO_COLOR", "1", || {
-        let handler = make_handler(MietteHandlerOpts::new()).build();
-        assert_eq!(color_format(handler), no_support);
-    });
-    with_env_var("FORCE_COLOR", "1", || {
-        let handler = make_handler(MietteHandlerOpts::new()).build();
-        assert_eq!(color_format(handler), ansi_support);
-    });
-    with_env_var("FORCE_COLOR", "3", || {
-        let handler = make_handler(MietteHandlerOpts::new()).build();
-        assert_eq!(color_format(handler), rgb_support);
-    });
+    let guards = (
+        EnvVarGuard::new("NO_COLOR"),
+        EnvVarGuard::new("FORCE_COLOR"),
+    );
+    // Clear color environment variables that may be set outside of 'cargo test'
+    std::env::remove_var("NO_COLOR");
+    std::env::remove_var("FORCE_COLOR");
 
-    drop(guard);
+    std::env::set_var("NO_COLOR", "1");
+    let handler = make_handler(MietteHandlerOpts::new()).build();
+    assert_eq!(color_format(handler), no_support);
+    std::env::remove_var("NO_COLOR");
+
+    std::env::set_var("FORCE_COLOR", "1");
+    let handler = make_handler(MietteHandlerOpts::new()).build();
+    assert_eq!(color_format(handler), ansi_support);
+    std::env::remove_var("FORCE_COLOR");
+
+    std::env::set_var("FORCE_COLOR", "3");
+    let handler = make_handler(MietteHandlerOpts::new()).build();
+    assert_eq!(color_format(handler), rgb_support);
+    std::env::remove_var("FORCE_COLOR");
+
+    drop(guards);
+    drop(lock);
 }
 
 #[test]

From cb2ae2e18b446a5e90885faf8a30b5672c307df8 Mon Sep 17 00:00:00 2001
From: Brooks Rady <b.j.rady@gmail.com>
Date: Wed, 31 Jan 2024 00:03:01 +0000
Subject: [PATCH 27/67] fix(graphical): render cause chains for inner errors
 (#330)

The default `GraphicalReportHandler` disables the printing of cause
chains for any inner errors (errors `related()` to a source diagnostic)
when it disables nested footer printing. This results in lost cause
chain information when printing with the default report handler.
---
 src/handlers/graphical.rs             | 16 ++++--
 tests/test_diagnostic_source_macro.rs | 82 +++++++++++++++++++++++++++
 2 files changed, 92 insertions(+), 6 deletions(-)

diff --git a/src/handlers/graphical.rs b/src/handlers/graphical.rs
index 021ba34..7812925 100644
--- a/src/handlers/graphical.rs
+++ b/src/handlers/graphical.rs
@@ -317,9 +317,10 @@ impl GraphicalReportHandler {
                     ErrorKind::Diagnostic(diag) => {
                         let mut inner = String::new();
 
-                        // Don't print footer for inner errors
                         let mut inner_renderer = self.clone();
+                        // Don't print footer for inner errors
                         inner_renderer.footer = None;
+                        // Cause chains are already flattened, so don't double-print the nested error
                         inner_renderer.with_cause_chain = false;
                         inner_renderer.render_report(&mut inner, diag)?;
 
@@ -362,6 +363,9 @@ impl GraphicalReportHandler {
         parent_src: Option<&dyn SourceCode>,
     ) -> fmt::Result {
         if let Some(related) = diagnostic.related() {
+            let mut inner_renderer = self.clone();
+            // Re-enable the printing of nested cause chains for related errors
+            inner_renderer.with_cause_chain = true;
             writeln!(f)?;
             for rel in related {
                 match rel.severity() {
@@ -369,12 +373,12 @@ impl GraphicalReportHandler {
                     Some(Severity::Warning) => write!(f, "Warning: ")?,
                     Some(Severity::Advice) => write!(f, "Advice: ")?,
                 };
-                self.render_header(f, rel)?;
-                self.render_causes(f, rel)?;
+                inner_renderer.render_header(f, rel)?;
+                inner_renderer.render_causes(f, rel)?;
                 let src = rel.source_code().or(parent_src);
-                self.render_snippets(f, rel, src)?;
-                self.render_footer(f, rel)?;
-                self.render_related(f, rel, src)?;
+                inner_renderer.render_snippets(f, rel, src)?;
+                inner_renderer.render_footer(f, rel)?;
+                inner_renderer.render_related(f, rel, src)?;
             }
         }
         Ok(())
diff --git a/tests/test_diagnostic_source_macro.rs b/tests/test_diagnostic_source_macro.rs
index 334ca34..e5305ac 100644
--- a/tests/test_diagnostic_source_macro.rs
+++ b/tests/test_diagnostic_source_macro.rs
@@ -194,3 +194,85 @@ fn test_nested_diagnostic_source_is_output() {
 
     assert_eq!(expected, out);
 }
+
+#[derive(Debug, miette::Diagnostic, thiserror::Error)]
+#[error("A multi-error happened")]
+struct MultiError {
+    #[related]
+    related_errs: Vec<Box<dyn Diagnostic>>,
+}
+
+#[cfg(feature = "fancy-no-backtrace")]
+#[test]
+fn test_nested_cause_chains_for_related_errors_are_output() {
+    let inner_error = TestStructError {
+        asdf_inner_foo: SourceError {
+            code: String::from("This is another error"),
+            help: String::from("You should fix this"),
+            label: (3, 4),
+        },
+    };
+    let first_error = NestedError {
+        code: String::from("right here"),
+        label: (6, 4),
+        the_other_err: Box::new(inner_error),
+    };
+    let second_error = SourceError {
+        code: String::from("You're actually a mess"),
+        help: String::from("Get a grip..."),
+        label: (3, 4),
+    };
+    let multi_error = MultiError {
+        related_errs: vec![Box::new(first_error), Box::new(second_error)],
+    };
+    let diag = NestedError {
+        code: String::from("the outside world"),
+        label: (6, 4),
+        the_other_err: Box::new(multi_error),
+    };
+    let mut out = String::new();
+    miette::GraphicalReportHandler::new_themed(miette::GraphicalTheme::unicode_nocolor())
+        .with_width(80)
+        .with_footer("Yooo, a footer".to_string())
+        .render_report(&mut out, &diag)
+        .unwrap();
+    println!("{}", out);
+
+    let expected = r#"  × A nested error happened
+  ╰─▶   × A multi-error happened
+      
+      Error:   × A nested error happened
+        ├─▶   × TestError
+        │
+        ╰─▶   × A complex error happened
+               ╭────
+             1 │ This is another error
+               ·    ──┬─
+               ·      ╰── here
+               ╰────
+              help: You should fix this
+      
+         ╭────
+       1 │ right here
+         ·       ──┬─
+         ·         ╰── here
+         ╰────
+      Error:   × A complex error happened
+         ╭────
+       1 │ You're actually a mess
+         ·    ──┬─
+         ·      ╰── here
+         ╰────
+        help: Get a grip...
+      
+   ╭────
+ 1 │ the outside world
+   ·       ──┬─
+   ·         ╰── here
+   ╰────
+
+  Yooo, a footer
+"#;
+
+    assert_eq!(expected, out);
+}

From f1dc89c07640445d224b61ef96c6b25fcdf62dee Mon Sep 17 00:00:00 2001
From: Boshen <boshenc@gmail.com>
Date: Sun, 4 Feb 2024 11:12:49 +0800
Subject: [PATCH 28/67] fix(handler): remove the two extra `is_terminal` sys
 call from `MietteHandlerOpts::build` (#325)

`GraphicalReportHandler::new()` calls `GraphicalTheme::default()`

https://github.com/zkat/miette/blob/7ff4f874d693a665af4df40f4e94505013e3e262/src/handlers/graphical.rs#L52

which calls `std::io::stdout().is_terminal()` and `std::io::stderr().is_terminal()`

https://github.com/zkat/miette/blob/7ff4f874d693a665af4df40f4e94505013e3e262/src/handlers/theme.rs#L72

but this default theme is overridden by `with_theme(theme)`.
---
 src/handler.rs | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/src/handler.rs b/src/handler.rs
index 38c9fc8..3c09373 100644
--- a/src/handler.rs
+++ b/src/handler.rs
@@ -247,10 +247,9 @@ impl MietteHandlerOpts {
                 ThemeStyles::none()
             };
             let theme = self.theme.unwrap_or(GraphicalTheme { characters, styles });
-            let mut handler = GraphicalReportHandler::new()
+            let mut handler = GraphicalReportHandler::new_themed(theme)
                 .with_width(width)
-                .with_links(linkify)
-                .with_theme(theme);
+                .with_links(linkify);
             if let Some(with_cause_chain) = self.with_cause_chain {
                 if with_cause_chain {
                     handler = handler.with_cause_chain();

From c0a298e5a8d699acf9fcd61b5d5fa4f6279a47ab Mon Sep 17 00:00:00 2001
From: John Nunley <jtnunley01@gmail.com>
Date: Sat, 3 Feb 2024 19:31:41 -0800
Subject: [PATCH 29/67] feat(deps): Bump terminal-size to v0.3.0 (#308)

BREAKING CHANGE: This requires an MSRV bump to 1.70.0.

Signed-off-by: John Nunley <dev@notgull.net>
---
 Cargo.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Cargo.toml b/Cargo.toml
index f8c2cb5..a730148 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -25,7 +25,7 @@ supports-hyperlinks = { version = "2.0.0", optional = true }
 supports-color = { version = "2.0.0", optional = true }
 supports-unicode = { version = "2.0.0", optional = true }
 backtrace = { version = "0.3.61", optional = true }
-terminal_size = { version = "0.1.17", optional = true }
+terminal_size = { version = "0.3.0", optional = true }
 backtrace-ext = { version = "0.2.1", optional = true }
 serde = { version = "1.0.162", features = ["derive"], optional = true }
 

From 0d5c2ce7536b0ea205346595d8a00d00bfb6cbd2 Mon Sep 17 00:00:00 2001
From: Gavrilikhin Daniil <gavrilikhin.daniil@gmail.com>
Date: Sun, 4 Feb 2024 06:33:59 +0300
Subject: [PATCH 30/67] feat(source-code): Don't override provided source code
 (#300)

BREAKING CHANGE: Source code is no longer overridden if it was provided by the diagnostic's own `source_code()` impl.
---
 src/eyreish/wrapper.rs | 89 +++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 87 insertions(+), 2 deletions(-)

diff --git a/src/eyreish/wrapper.rs b/src/eyreish/wrapper.rs
index 91a5ef3..6e65eb7 100644
--- a/src/eyreish/wrapper.rs
+++ b/src/eyreish/wrapper.rs
@@ -163,7 +163,7 @@ impl<E: Diagnostic, C: SourceCode> Diagnostic for WithSourceCode<E, C> {
     }
 
     fn source_code(&self) -> Option<&dyn miette::SourceCode> {
-        Some(&self.source_code)
+        self.error.source_code().or(Some(&self.source_code))
     }
 
     fn related<'a>(&'a self) -> Option<Box<dyn Iterator<Item = &'a dyn Diagnostic> + 'a>> {
@@ -197,7 +197,7 @@ impl<C: SourceCode> Diagnostic for WithSourceCode<Report, C> {
     }
 
     fn source_code(&self) -> Option<&dyn miette::SourceCode> {
-        Some(&self.source_code)
+        self.error.source_code().or(Some(&self.source_code))
     }
 
     fn related<'a>(&'a self) -> Option<Box<dyn Iterator<Item = &'a dyn Diagnostic> + 'a>> {
@@ -232,3 +232,88 @@ impl<C> StdError for WithSourceCode<Report, C> {
         self.error.source()
     }
 }
+
+#[cfg(test)]
+mod tests {
+    use thiserror::Error;
+
+    use crate::{Diagnostic, LabeledSpan, Report, SourceCode, SourceSpan};
+
+    #[derive(Error, Debug)]
+    #[error("inner")]
+    struct Inner {
+        pub(crate) at: SourceSpan,
+        pub(crate) source_code: Option<String>,
+    }
+
+    impl Diagnostic for Inner {
+        fn labels(&self) -> Option<Box<dyn Iterator<Item = LabeledSpan> + '_>> {
+            Some(Box::new(std::iter::once(LabeledSpan::underline(self.at))))
+        }
+
+        fn source_code(&self) -> Option<&dyn SourceCode> {
+            self.source_code.as_ref().map(|s| s as _)
+        }
+    }
+
+    #[derive(Error, Debug)]
+    #[error("outer")]
+    struct Outer {
+        pub(crate) errors: Vec<Inner>,
+    }
+
+    impl Diagnostic for Outer {
+        fn related<'a>(&'a self) -> Option<Box<dyn Iterator<Item = &'a dyn Diagnostic> + 'a>> {
+            Some(Box::new(self.errors.iter().map(|e| e as _)))
+        }
+    }
+
+    #[test]
+    fn no_override() {
+        let inner_source = "hello world";
+        let outer_source = "abc";
+
+        let report = Report::from(Inner {
+            at: (0..5).into(),
+            source_code: Some(inner_source.to_string()),
+        })
+        .with_source_code(outer_source.to_string());
+
+        let underlined = String::from_utf8(
+            report
+                .source_code()
+                .unwrap()
+                .read_span(&(0..5).into(), 0, 0)
+                .unwrap()
+                .data()
+                .to_vec(),
+        )
+        .unwrap();
+        assert_eq!(underlined, "hello");
+    }
+
+    #[test]
+    #[cfg(feature = "fancy")]
+    fn two_source_codes() {
+        let inner_source = "hello world";
+        let outer_source = "abc";
+
+        let report = Report::from(Outer {
+            errors: vec![
+                Inner {
+                    at: (0..5).into(),
+                    source_code: Some(inner_source.to_string()),
+                },
+                Inner {
+                    at: (1..2).into(),
+                    source_code: None,
+                },
+            ],
+        })
+        .with_source_code(outer_source.to_string());
+
+        let message = format!("{:?}", report);
+        assert!(message.contains(inner_source));
+        assert!(message.contains(outer_source));
+    }
+}

From fad0e76ad2e19d5cac13cf8324338aca0d623d93 Mon Sep 17 00:00:00 2001
From: Gavrilikhin Daniil <gavrilikhin.daniil@gmail.com>
Date: Sun, 4 Feb 2024 06:38:00 +0300
Subject: [PATCH 31/67] feat(source): use `usize` for length (#265)

BREAKING CHANGE: This changes `SourceSpan`'s length type to `usize`.
---
 src/protocol.rs | 8 ++++----
 tests/derive.rs | 2 +-
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/protocol.rs b/src/protocol.rs
index 4a6012c..b403494 100644
--- a/src/protocol.rs
+++ b/src/protocol.rs
@@ -526,10 +526,10 @@ pub struct SourceSpan {
 
 impl SourceSpan {
     /// Create a new [`SourceSpan`].
-    pub const fn new(start: SourceOffset, length: SourceOffset) -> Self {
+    pub const fn new(start: SourceOffset, length: usize) -> Self {
         Self {
             offset: start,
-            length: length.offset(),
+            length,
         }
     }
 
@@ -559,8 +559,8 @@ impl From<(ByteOffset, usize)> for SourceSpan {
     }
 }
 
-impl From<(SourceOffset, SourceOffset)> for SourceSpan {
-    fn from((start, len): (SourceOffset, SourceOffset)) -> Self {
+impl From<(SourceOffset, usize)> for SourceSpan {
+    fn from((start, len): (SourceOffset, usize)) -> Self {
         Self::new(start, len)
     }
 }
diff --git a/tests/derive.rs b/tests/derive.rs
index d1da1bb..ac29eee 100644
--- a/tests/derive.rs
+++ b/tests/derive.rs
@@ -406,7 +406,7 @@ impl ForwardsTo {
     fn new() -> Self {
         ForwardsTo {
             src: SNIPPET_TEXT.into(),
-            label: SourceSpan::new(11.into(), 6.into()),
+            label: SourceSpan::new(11.into(), 6),
         }
     }
 }

From 1df3b1a537f2e54cd40ec45f5cd851337a22e95a Mon Sep 17 00:00:00 2001
From: Adam Curtis <adam.curtis.dev@gmail.com>
Date: Sat, 3 Feb 2024 22:40:17 -0500
Subject: [PATCH 32/67] feat(source): Allow inner source type of a NamedSource
 to be borrowed (#254)

BREAKING CHANGE: This makes the `NamedSource` type generic over its `Source` type, instead of boxing it.
---
 README.md                 |  2 +-
 src/lib.rs                |  2 +-
 src/named_source.rs       | 21 ++++++++-------
 tests/graphical.rs        | 56 +++++++++++++++++++--------------------
 tests/narrated.rs         | 30 ++++++++++-----------
 tests/test_derive_attr.rs | 12 ++++-----
 tests/test_json.rs        | 30 ++++++++++-----------
 7 files changed, 78 insertions(+), 75 deletions(-)

diff --git a/README.md b/README.md
index 5f79c52..8af2845 100644
--- a/README.md
+++ b/README.md
@@ -110,7 +110,7 @@ struct MyBad {
     // The Source that we're gonna be printing snippets out of.
     // This can be a String if you don't have or care about file names.
     #[source_code]
-    src: NamedSource,
+    src: NamedSource<String>,
     // Snippets and highlights can be included in the diagnostic!
     #[label("This bit here")]
     bad_bit: SourceSpan,
diff --git a/src/lib.rs b/src/lib.rs
index d80efa7..862e242 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -109,7 +109,7 @@
 //!     // The Source that we're gonna be printing snippets out of.
 //!     // This can be a String if you don't have or care about file names.
 //!     #[source_code]
-//!     src: NamedSource,
+//!     src: NamedSource<String>,
 //!     // Snippets and highlights can be included in the diagnostic!
 //!     #[label("This bit here")]
 //!     bad_bit: SourceSpan,
diff --git a/src/named_source.rs b/src/named_source.rs
index 31ad1d1..8b0b75a 100644
--- a/src/named_source.rs
+++ b/src/named_source.rs
@@ -3,12 +3,12 @@ use crate::{MietteError, MietteSpanContents, SourceCode, SpanContents};
 /// Utility struct for when you have a regular [`SourceCode`] type that doesn't
 /// implement `name`. For example [`String`]. Or if you want to override the
 /// `name` returned by the `SourceCode`.
-pub struct NamedSource {
-    source: Box<dyn SourceCode + 'static>,
+pub struct NamedSource<S: SourceCode + 'static> {
+    source: S,
     name: String,
 }
 
-impl std::fmt::Debug for NamedSource {
+impl<S: SourceCode> std::fmt::Debug for NamedSource<S> {
     fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
         f.debug_struct("NamedSource")
             .field("name", &self.name)
@@ -17,12 +17,15 @@ impl std::fmt::Debug for NamedSource {
     }
 }
 
-impl NamedSource {
+impl<S: SourceCode + 'static> NamedSource<S> {
     /// Create a new `NamedSource` using a regular [`SourceCode`] and giving
     /// its returned [`SpanContents`] a name.
-    pub fn new(name: impl AsRef<str>, source: impl SourceCode + Send + Sync + 'static) -> Self {
+    pub fn new(name: impl AsRef<str>, source: S) -> Self
+    where
+        S: Send + Sync,
+    {
         Self {
-            source: Box::new(source),
+            source,
             name: name.as_ref().to_string(),
         }
     }
@@ -34,12 +37,12 @@ impl NamedSource {
 
     /// Returns a reference the inner [`SourceCode`] type for this
     /// `NamedSource`.
-    pub fn inner(&self) -> &(dyn SourceCode + 'static) {
-        &*self.source
+    pub fn inner(&self) -> &S {
+        &self.source
     }
 }
 
-impl SourceCode for NamedSource {
+impl<S: SourceCode + 'static> SourceCode for NamedSource<S> {
     fn read_span<'a>(
         &'a self,
         span: &crate::SourceSpan,
diff --git a/tests/graphical.rs b/tests/graphical.rs
index 4e8b737..ffb701c 100644
--- a/tests/graphical.rs
+++ b/tests/graphical.rs
@@ -269,7 +269,7 @@ fn empty_source() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this bit here")]
         highlight: SourceSpan,
     }
@@ -348,7 +348,7 @@ fn single_line_highlight_span_full_line() {
     #[diagnostic(severity(Error))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<&'static str>,
         #[label("This bit here")]
         bad_bit: SourceSpan,
     }
@@ -379,7 +379,7 @@ fn single_line_with_wide_char() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this bit here")]
         highlight: SourceSpan,
     }
@@ -416,7 +416,7 @@ fn single_line_with_two_tabs() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this bit here")]
         highlight: SourceSpan,
     }
@@ -455,7 +455,7 @@ fn single_line_with_tab_in_middle() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this bit here")]
         highlight: SourceSpan,
     }
@@ -494,7 +494,7 @@ fn single_line_highlight() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this bit here")]
         highlight: SourceSpan,
     }
@@ -566,7 +566,7 @@ fn single_line_highlight_offset_zero() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this bit here")]
         highlight: SourceSpan,
     }
@@ -602,7 +602,7 @@ fn single_line_highlight_offset_end_of_line() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this bit here")]
         highlight: SourceSpan,
     }
@@ -638,7 +638,7 @@ fn single_line_highlight_include_end_of_line() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this bit here")]
         highlight: SourceSpan,
     }
@@ -675,7 +675,7 @@ fn single_line_highlight_include_end_of_line_crlf() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this bit here")]
         highlight: SourceSpan,
     }
@@ -712,7 +712,7 @@ fn single_line_highlight_with_empty_span() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this bit here")]
         highlight: SourceSpan,
     }
@@ -749,7 +749,7 @@ fn single_line_highlight_no_label() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label]
         highlight: SourceSpan,
     }
@@ -785,7 +785,7 @@ fn single_line_highlight_at_line_start() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this bit here")]
         highlight: SourceSpan,
     }
@@ -910,7 +910,7 @@ fn multiple_same_line_highlights() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label = "x"]
         highlight1: SourceSpan,
         #[label = "y"]
@@ -955,7 +955,7 @@ fn multiple_same_line_highlights_with_tabs_in_middle() -> Result<(), MietteError
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label = "x"]
         highlight1: SourceSpan,
         #[label = "y"]
@@ -1002,7 +1002,7 @@ fn multiline_highlight_adjacent() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label = "these two lines"]
         highlight: SourceSpan,
     }
@@ -1075,7 +1075,7 @@ fn multiline_highlight_flyby() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label = "block 1"]
         highlight1: SourceSpan,
         #[label = "block 2"]
@@ -1126,7 +1126,7 @@ fn multiline_highlight_no_label() -> Result<(), MietteError> {
         #[source]
         source: Inner,
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label = "block 1"]
         highlight1: SourceSpan,
         #[label]
@@ -1190,7 +1190,7 @@ fn multiple_multiline_highlights_adjacent() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label = "this bit here"]
         highlight1: SourceSpan,
         #[label = "also this bit"]
@@ -1236,7 +1236,7 @@ fn multiple_multiline_highlights_overlapping_lines() -> Result<(), MietteError>
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label = "this bit here"]
         highlight1: SourceSpan,
         #[label = "also this bit"]
@@ -1264,7 +1264,7 @@ fn multiple_multiline_highlights_overlapping_offsets() -> Result<(), MietteError
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label = "this bit here"]
         highlight1: SourceSpan,
         #[label = "also this bit"]
@@ -1346,7 +1346,7 @@ fn related() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this bit here")]
         highlight: SourceSpan,
         #[related]
@@ -1402,7 +1402,7 @@ fn related_source_code_propagation() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this bit here")]
         highlight: SourceSpan,
         #[related]
@@ -1462,7 +1462,7 @@ fn related_severity() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this bit here")]
         highlight: SourceSpan,
         #[related]
@@ -1479,7 +1479,7 @@ fn related_severity() -> Result<(), MietteError> {
         )]
         Error {
             #[source_code]
-            src: NamedSource,
+            src: NamedSource<String>,
             #[label("this bit here")]
             highlight: SourceSpan,
         },
@@ -1492,7 +1492,7 @@ fn related_severity() -> Result<(), MietteError> {
         )]
         Warning {
             #[source_code]
-            src: NamedSource,
+            src: NamedSource<String>,
             #[label("this bit here")]
             highlight: SourceSpan,
         },
@@ -1505,7 +1505,7 @@ fn related_severity() -> Result<(), MietteError> {
         )]
         Advice {
             #[source_code]
-            src: NamedSource,
+            src: NamedSource<String>,
             #[label("this bit here")]
             highlight: SourceSpan,
         },
@@ -1588,7 +1588,7 @@ fn zero_length_eol_span() {
     #[diagnostic(severity(Error))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<&'static str>,
         #[label("This bit here")]
         bad_bit: SourceSpan,
     }
diff --git a/tests/narrated.rs b/tests/narrated.rs
index 0bdb41d..52acd13 100644
--- a/tests/narrated.rs
+++ b/tests/narrated.rs
@@ -29,7 +29,7 @@ fn single_line_with_wide_char() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this bit here")]
         highlight: SourceSpan,
     }
@@ -65,7 +65,7 @@ fn single_line_highlight() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this bit here")]
         highlight: SourceSpan,
     }
@@ -101,7 +101,7 @@ fn single_line_highlight_offset_zero() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this bit here")]
         highlight: SourceSpan,
     }
@@ -136,7 +136,7 @@ fn single_line_highlight_with_empty_span() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this bit here")]
         highlight: SourceSpan,
     }
@@ -172,7 +172,7 @@ fn single_line_highlight_no_label() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label]
         highlight: SourceSpan,
     }
@@ -208,7 +208,7 @@ fn single_line_highlight_at_line_start() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this bit here")]
         highlight: SourceSpan,
     }
@@ -244,7 +244,7 @@ fn multiple_same_line_highlights() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label = "x"]
         highlight1: SourceSpan,
         #[label = "y"]
@@ -288,7 +288,7 @@ fn multiline_highlight_adjacent() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label = "these two lines"]
         highlight: SourceSpan,
     }
@@ -325,7 +325,7 @@ fn multiline_highlight_flyby() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label = "block 1"]
         highlight1: SourceSpan,
         #[label = "block 2"]
@@ -378,7 +378,7 @@ fn multiline_highlight_no_label() -> Result<(), MietteError> {
         #[source]
         source: Inner,
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label = "block 1"]
         highlight1: SourceSpan,
         #[label]
@@ -444,7 +444,7 @@ fn multiple_multiline_highlights_adjacent() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label = "this bit here"]
         highlight1: SourceSpan,
         #[label = "also this bit"]
@@ -492,7 +492,7 @@ fn multiple_multiline_highlights_overlapping_lines() -> Result<(), MietteError>
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label = "this bit here"]
         highlight1: SourceSpan,
         #[label = "also this bit"]
@@ -520,7 +520,7 @@ fn multiple_multiline_highlights_overlapping_offsets() -> Result<(), MietteError
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label = "this bit here"]
         highlight1: SourceSpan,
         #[label = "also this bit"]
@@ -559,7 +559,7 @@ fn related() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this bit here")]
         highlight: SourceSpan,
         #[related]
@@ -614,7 +614,7 @@ fn related_source_code_propagation() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this bit here")]
         highlight: SourceSpan,
         #[related]
diff --git a/tests/test_derive_attr.rs b/tests/test_derive_attr.rs
index 5ee950a..f1b0f3d 100644
--- a/tests/test_derive_attr.rs
+++ b/tests/test_derive_attr.rs
@@ -10,7 +10,7 @@ fn enum_uses_base_attr() {
     enum MyBad {
         Only {
             #[source_code]
-            src: NamedSource,
+            src: NamedSource<String>,
             #[label("this bit here")]
             highlight: SourceSpan,
         },
@@ -32,7 +32,7 @@ fn enum_uses_variant_attr() {
         #[diagnostic(code(error::on::variant))]
         Only {
             #[source_code]
-            src: NamedSource,
+            src: NamedSource<String>,
             #[label("this bit here")]
             highlight: SourceSpan,
         },
@@ -55,7 +55,7 @@ fn multiple_attrs_allowed_on_item() {
     enum MyBad {
         Only {
             #[source_code]
-            src: NamedSource,
+            src: NamedSource<String>,
             #[label("this bit here")]
             highlight: SourceSpan,
         },
@@ -79,7 +79,7 @@ fn multiple_attrs_allowed_on_variant() {
         #[diagnostic(help("try doing it correctly"))]
         Only {
             #[source_code]
-            src: NamedSource,
+            src: NamedSource<String>,
             #[label("this bit here")]
             highlight: SourceSpan,
         },
@@ -104,7 +104,7 @@ fn attrs_can_be_split_between_item_and_variants() {
         #[diagnostic(url("https://example.com/foo/bar"))]
         Only {
             #[source_code]
-            src: NamedSource,
+            src: NamedSource<String>,
             #[label("this bit here")]
             highlight: SourceSpan,
         },
@@ -130,7 +130,7 @@ fn attr_not_required() {
     enum MyBad {
         Only {
             #[source_code]
-            src: NamedSource,
+            src: NamedSource<String>,
             #[label("this bit here")]
             highlight: SourceSpan,
         },
diff --git a/tests/test_json.rs b/tests/test_json.rs
index ae482b8..664318a 100644
--- a/tests/test_json.rs
+++ b/tests/test_json.rs
@@ -20,7 +20,7 @@ mod json_report_handler {
         #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
         struct MyBad {
             #[source_code]
-            src: NamedSource,
+            src: NamedSource<String>,
             #[label("this bit here")]
             highlight: SourceSpan,
         }
@@ -65,7 +65,7 @@ mod json_report_handler {
         #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
         struct MyBad {
             #[source_code]
-            src: NamedSource,
+            src: NamedSource<String>,
             #[label("this bit here")]
             highlight: SourceSpan,
         }
@@ -110,7 +110,7 @@ mod json_report_handler {
         #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
         struct MyBad {
             #[source_code]
-            src: NamedSource,
+            src: NamedSource<String>,
             #[label("this bit here")]
             highlight: SourceSpan,
         }
@@ -155,7 +155,7 @@ mod json_report_handler {
         #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
         struct MyBad {
             #[source_code]
-            src: NamedSource,
+            src: NamedSource<String>,
             #[label("this bit here")]
             highlight: SourceSpan,
         }
@@ -200,7 +200,7 @@ mod json_report_handler {
         #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
         struct MyBad {
             #[source_code]
-            src: NamedSource,
+            src: NamedSource<String>,
             #[label]
             highlight: SourceSpan,
         }
@@ -244,7 +244,7 @@ mod json_report_handler {
         #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
         struct MyBad {
             #[source_code]
-            src: NamedSource,
+            src: NamedSource<String>,
             #[label("this bit here")]
             highlight: SourceSpan,
         }
@@ -289,7 +289,7 @@ mod json_report_handler {
         #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
         struct MyBad {
             #[source_code]
-            src: NamedSource,
+            src: NamedSource<String>,
             #[label = "x"]
             highlight1: SourceSpan,
             #[label = "y"]
@@ -354,7 +354,7 @@ mod json_report_handler {
         #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
         struct MyBad {
             #[source_code]
-            src: NamedSource,
+            src: NamedSource<String>,
             #[label = "these two lines"]
             highlight: SourceSpan,
         }
@@ -399,7 +399,7 @@ mod json_report_handler {
         #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
         struct MyBad {
             #[source_code]
-            src: NamedSource,
+            src: NamedSource<String>,
             #[label = "block 1"]
             highlight1: SourceSpan,
             #[label = "block 2"]
@@ -463,7 +463,7 @@ mod json_report_handler {
             #[source]
             source: Inner,
             #[source_code]
-            src: NamedSource,
+            src: NamedSource<String>,
             #[label = "block 1"]
             highlight1: SourceSpan,
             #[label]
@@ -536,7 +536,7 @@ mod json_report_handler {
         #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
         struct MyBad {
             #[source_code]
-            src: NamedSource,
+            src: NamedSource<String>,
             #[label = "this bit here"]
             highlight1: SourceSpan,
             #[label = "also this bit"]
@@ -591,7 +591,7 @@ mod json_report_handler {
         #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
         struct MyBad {
             #[source_code]
-            src: NamedSource,
+            src: NamedSource<String>,
             #[label = "this bit here"]
             highlight1: SourceSpan,
             #[label = "also this bit"]
@@ -646,7 +646,7 @@ mod json_report_handler {
         #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
         struct MyBad {
             #[source_code]
-            src: NamedSource,
+            src: NamedSource<String>,
             #[label = "this bit here"]
             highlight1: SourceSpan,
             #[label = "also this bit"]
@@ -728,7 +728,7 @@ mod json_report_handler {
         #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
         struct MyBad {
             #[source_code]
-            src: NamedSource,
+            src: NamedSource<String>,
             #[label("this bit here")]
             highlight: SourceSpan,
             #[related]
@@ -821,7 +821,7 @@ mod json_report_handler {
         #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
         struct MyBad {
             #[source_code]
-            src: NamedSource,
+            src: NamedSource<String>,
             #[label("this bit here")]
             highlight: SourceSpan,
             #[related]

From e65d0a78cc639653f061a45d8ce35b1a3551ade7 Mon Sep 17 00:00:00 2001
From: Adam Curtis <adam.curtis.dev@gmail.com>
Date: Sat, 3 Feb 2024 22:47:46 -0500
Subject: [PATCH 33/67] feat(highlighting): add syntax highlighting support
 with syntect crate (#313)

---
 .github/workflows/ci.yml    |  11 ++-
 Cargo.toml                  |   5 +-
 src/handler.rs              |  66 +++++++++++++-
 src/handlers/graphical.rs   |  50 +++++++++--
 src/highlighters/blank.rs   |  36 ++++++++
 src/highlighters/mod.rs     | 116 ++++++++++++++++++++++++
 src/highlighters/syntect.rs | 170 ++++++++++++++++++++++++++++++++++++
 src/lib.rs                  |  31 +++++++
 src/named_source.rs         |  35 +++++---
 src/protocol.rs             |  22 +++++
 tests/graphical.rs          |  98 +++++++++++++++++++++
 11 files changed, 617 insertions(+), 23 deletions(-)
 create mode 100644 src/highlighters/blank.rs
 create mode 100644 src/highlighters/mod.rs
 create mode 100644 src/highlighters/syntect.rs

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 912bfcc..32125cc 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -26,8 +26,12 @@ jobs:
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
+        features: [fancy, syntect-highlighter]
         rust: [1.56.0, stable]
         os: [ubuntu-latest, macOS-latest, windows-latest]
+        exclude:
+          - features: syntect-highlighter
+            rust: 1.56.0
 
     steps:
       - uses: actions/checkout@v4
@@ -43,10 +47,10 @@ jobs:
         run: cargo clippy --all -- -D warnings
       - name: Run tests
         if: matrix.rust == 'stable'
-        run: cargo test --all --verbose --features fancy
+        run: cargo test --all --verbose --features ${{matrix.features}}
       - name: Run tests
         if: matrix.rust == '1.56.0'
-        run: cargo test --all --verbose --features fancy no-format-args-capture
+        run: cargo test --all --verbose --features ${{matrix.features}} no-format-args-capture
 
   miri:
     name: Miri
@@ -78,5 +82,4 @@ jobs:
         with:
           toolchain: nightly
       - name: Run minimal version build
-        run: cargo build -Z minimal-versions --all-features
-
+        run: cargo build -Z minimal-versions --features fancy,no-format-args-capture
diff --git a/Cargo.toml b/Cargo.toml
index a730148..0123cc0 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -18,7 +18,7 @@ miette-derive = { path = "miette-derive", version = "=5.10.0", optional = true }
 once_cell = "1.8.0"
 unicode-width = "0.1.9"
 
-owo-colors = { version = "3.0.0", optional = true }
+owo-colors = { version = "3.4.0", optional = true }
 is-terminal = { version = "0.4.0", optional = true }
 textwrap = { version = "0.15.0", optional = true }
 supports-hyperlinks = { version = "2.0.0", optional = true }
@@ -28,6 +28,7 @@ backtrace = { version = "0.3.61", optional = true }
 terminal_size = { version = "0.3.0", optional = true }
 backtrace-ext = { version = "0.2.1", optional = true }
 serde = { version = "1.0.162", features = ["derive"], optional = true }
+syntect = { version = "5.1.0", optional = true }
 
 [dev-dependencies]
 semver = "1.0.4"
@@ -42,6 +43,7 @@ regex = "1.5"
 lazy_static = "1.4"
 
 serde_json = "1.0.64"
+strip-ansi-escapes = "0.2.0"
 
 [features]
 default = ["derive"]
@@ -57,6 +59,7 @@ fancy-no-backtrace = [
     "supports-unicode",
 ]
 fancy = ["fancy-no-backtrace", "backtrace", "backtrace-ext"]
+syntect-highlighter = ["fancy-no-backtrace", "syntect"]
 
 [workspace]
 members = ["miette-derive"]
diff --git a/src/handler.rs b/src/handler.rs
index 3c09373..a564f44 100644
--- a/src/handler.rs
+++ b/src/handler.rs
@@ -1,5 +1,7 @@
 use std::fmt;
 
+use crate::highlighters::Highlighter;
+use crate::highlighters::MietteHighlighter;
 use crate::protocol::Diagnostic;
 use crate::GraphicalReportHandler;
 use crate::GraphicalTheme;
@@ -59,6 +61,7 @@ pub struct MietteHandlerOpts {
     pub(crate) wrap_lines: Option<bool>,
     pub(crate) word_separator: Option<textwrap::WordSeparator>,
     pub(crate) word_splitter: Option<textwrap::WordSplitter>,
+    pub(crate) highlighter: Option<MietteHighlighter>,
 }
 
 impl MietteHandlerOpts {
@@ -84,6 +87,43 @@ impl MietteHandlerOpts {
         self
     }
 
+    /// Set a syntax highlighter when rendering in graphical mode.
+    /// Use [`force_graphical()`](MietteHandlerOpts::force_graphical()) to
+    /// force graphical mode.
+    ///
+    /// Syntax highlighting is disabled by default unless the
+    /// `syntect-highlighter` feature is enabled. Call this method
+    /// to override the default and use a custom highlighter
+    /// implmentation instead.
+    ///
+    /// Use
+    /// [`without_syntax_highlighting()`](MietteHandlerOpts::without_syntax_highlighting())
+    /// To disable highlighting completely.
+    ///
+    /// Setting this option will not force color output. In all cases, the
+    /// current color configuration via
+    /// [`color()`](MietteHandlerOpts::color()) takes precedence over
+    /// highlighter configuration.
+    pub fn with_syntax_highlighting(
+        mut self,
+        highlighter: impl Highlighter + Send + Sync + 'static,
+    ) -> Self {
+        self.highlighter = Some(MietteHighlighter::from(highlighter));
+        self
+    }
+
+    /// Disables syntax highlighting when rendering in graphical mode.
+    /// Use [`force_graphical()`](MietteHandlerOpts::force_graphical()) to
+    /// force graphical mode.
+    ///
+    /// Syntax highlighting is disabled by default unless the
+    /// `syntect-highlighter` feature is enabled. Call this method if you want
+    /// to disable highlighting when building with this feature.
+    pub fn without_syntax_highlighting(mut self) -> Self {
+        self.highlighter = Some(MietteHighlighter::nocolor());
+        self
+    }
+
     /// Sets the width to wrap the report at. Defaults to 80.
     pub fn width(mut self, width: usize) -> Self {
         self.width = Some(width);
@@ -246,10 +286,34 @@ impl MietteHandlerOpts {
             } else {
                 ThemeStyles::none()
             };
+            #[cfg(not(feature = "syntect-highlighter"))]
+            let highlighter = self.highlighter.unwrap_or_else(MietteHighlighter::nocolor);
+            #[cfg(feature = "syntect-highlighter")]
+            let highlighter = if self.color == Some(false) {
+                MietteHighlighter::nocolor()
+            } else if self.color == Some(true)
+                || supports_color::on(supports_color::Stream::Stderr).is_some()
+            {
+                match self.highlighter {
+                    Some(highlighter) => highlighter,
+                    None => match self.rgb_colors {
+                        // Because the syntect highlighter currently only supports 24-bit truecolor,
+                        // respect RgbColor::Never by disabling the highlighter.
+                        // TODO: In the future, find a way to convert the RGB syntect theme
+                        // into an ANSI color theme.
+                        RgbColors::Never => MietteHighlighter::nocolor(),
+                        _ => MietteHighlighter::syntect_truecolor(),
+                    },
+                }
+            } else {
+                MietteHighlighter::nocolor()
+            };
             let theme = self.theme.unwrap_or(GraphicalTheme { characters, styles });
             let mut handler = GraphicalReportHandler::new_themed(theme)
                 .with_width(width)
-                .with_links(linkify);
+                .with_links(linkify)
+                .with_theme(theme);
+            handler.highlighter = highlighter;
             if let Some(with_cause_chain) = self.with_cause_chain {
                 if with_cause_chain {
                     handler = handler.with_cause_chain();
diff --git a/src/handlers/graphical.rs b/src/handlers/graphical.rs
index 7812925..d7e1883 100644
--- a/src/handlers/graphical.rs
+++ b/src/handlers/graphical.rs
@@ -1,10 +1,11 @@
 use std::fmt::{self, Write};
 
-use owo_colors::{OwoColorize, Style};
+use owo_colors::{OwoColorize, Style, StyledList};
 use unicode_width::UnicodeWidthChar;
 
 use crate::diagnostic_chain::{DiagnosticChain, ErrorKind};
 use crate::handlers::theme::*;
+use crate::highlighters::{Highlighter, MietteHighlighter};
 use crate::protocol::{Diagnostic, Severity};
 use crate::{LabeledSpan, ReportHandler, SourceCode, SourceSpan, SpanContents};
 
@@ -34,6 +35,7 @@ pub struct GraphicalReportHandler {
     pub(crate) break_words: bool,
     pub(crate) word_separator: Option<textwrap::WordSeparator>,
     pub(crate) word_splitter: Option<textwrap::WordSplitter>,
+    pub(crate) highlighter: MietteHighlighter,
 }
 
 #[derive(Debug, Clone, Copy, PartialEq, Eq)]
@@ -59,6 +61,7 @@ impl GraphicalReportHandler {
             break_words: true,
             word_separator: None,
             word_splitter: None,
+            highlighter: MietteHighlighter::default(),
         }
     }
 
@@ -76,6 +79,7 @@ impl GraphicalReportHandler {
             break_words: true,
             word_separator: None,
             word_splitter: None,
+            highlighter: MietteHighlighter::default(),
         }
     }
 
@@ -169,6 +173,23 @@ impl GraphicalReportHandler {
         self.context_lines = lines;
         self
     }
+
+    /// Enable syntax highlighting for source code snippets, using the given
+    /// [`Highlighter`]. See the [crate::highlighters] crate for more details.
+    pub fn with_syntax_highlighting(
+        mut self,
+        highlighter: impl Highlighter + Send + Sync + 'static,
+    ) -> Self {
+        self.highlighter = MietteHighlighter::from(highlighter);
+        self
+    }
+
+    /// Disable syntax highlighting. This uses the
+    /// [`crate::highlighters::BlankHighlighter`] as a no-op highlighter.
+    pub fn without_syntax_highlighting(mut self) -> Self {
+        self.highlighter = MietteHighlighter::nocolor();
+        self
+    }
 }
 
 impl Default for GraphicalReportHandler {
@@ -472,6 +493,8 @@ impl GraphicalReportHandler {
             .map(|(label, st)| FancySpan::new(label.label().map(String::from), *label.inner(), st))
             .collect::<Vec<_>>();
 
+        let mut highlighter_state = self.highlighter.start_highlighter_state(&*contents);
+
         // The max number of gutter-lines that will be active at any given
         // point. We need this to figure out indentation, so we do one loop
         // over the lines to see what the damage is gonna be.
@@ -545,7 +568,9 @@ impl GraphicalReportHandler {
             self.render_line_gutter(f, max_gutter, line, &labels)?;
 
             // And _now_ we can print out the line text itself!
-            self.render_line_text(f, &line.text)?;
+            let styled_text =
+                StyledList::from(highlighter_state.highlight_line(&line.text)).to_string();
+            self.render_line_text(f, &styled_text)?;
 
             // Next, we write all the highlights that apply to this particular line.
             let (single_line, multi_line): (Vec<_>, Vec<_>) = labels
@@ -881,13 +906,26 @@ impl GraphicalReportHandler {
     /// Returns an iterator over the visual width of each character in a line.
     fn line_visual_char_width<'a>(&self, text: &'a str) -> impl Iterator<Item = usize> + 'a {
         let mut column = 0;
+        let mut escaped = false;
         let tab_width = self.tab_width;
         text.chars().map(move |c| {
-            let width = if c == '\t' {
+            let width = match (escaped, c) {
                 // Round up to the next multiple of tab_width
-                tab_width - column % tab_width
-            } else {
-                c.width().unwrap_or(0)
+                (false, '\t') => tab_width - column % tab_width,
+                // start of ANSI escape
+                (false, '\x1b') => {
+                    escaped = true;
+                    0
+                }
+                // use Unicode width for all other characters
+                (false, c) => c.width().unwrap_or(0),
+                // end of ANSI escape
+                (true, 'm') => {
+                    escaped = false;
+                    0
+                }
+                // characters are zero width within escape sequence
+                (true, _) => 0,
             };
             column += width;
             width
diff --git a/src/highlighters/blank.rs b/src/highlighters/blank.rs
new file mode 100644
index 0000000..50a9c65
--- /dev/null
+++ b/src/highlighters/blank.rs
@@ -0,0 +1,36 @@
+use owo_colors::Style;
+
+use crate::SpanContents;
+
+use super::{Highlighter, HighlighterState};
+
+/// The default syntax highlighter. It applies `Style::default()` to input text.
+/// This is used by default when no syntax highlighting features are enabled.
+#[derive(Debug, Clone)]
+pub struct BlankHighlighter;
+
+impl Highlighter for BlankHighlighter {
+    fn start_highlighter_state<'h>(
+        &'h self,
+        _source: &dyn SpanContents<'_>,
+    ) -> Box<dyn super::HighlighterState + 'h> {
+        Box::new(BlankHighlighterState)
+    }
+}
+
+impl Default for BlankHighlighter {
+    fn default() -> Self {
+        BlankHighlighter
+    }
+}
+
+/// The default highlighter state. It applies `Style::default()` to input text.
+/// This is used by default when no syntax highlighting features are enabled.
+#[derive(Debug, Clone)]
+pub struct BlankHighlighterState;
+
+impl HighlighterState for BlankHighlighterState {
+    fn highlight_line<'s>(&mut self, line: &'s str) -> Vec<owo_colors::Styled<&'s str>> {
+        vec![Style::default().style(line)]
+    }
+}
diff --git a/src/highlighters/mod.rs b/src/highlighters/mod.rs
new file mode 100644
index 0000000..47e7f7c
--- /dev/null
+++ b/src/highlighters/mod.rs
@@ -0,0 +1,116 @@
+//! This module provides a trait for creating custom syntax highlighters that
+//! highlight [`Diagnostic`](crate::Diagnostic) source code with ANSI escape
+//! sequences when rendering with the [`GraphicalReportHighlighter`](crate::GraphicalReportHandler).
+//!
+//! It also provides built-in highlighter implementations that you can use out of the box.
+//! By default, there are no syntax highlighters exported by miette
+//! (except for the no-op [`BlankHighlighter`]).
+//! To enable support for specific highlighters, you should enable their associated feature flag.
+//!
+//! Currently supported syntax highlighters and their feature flags:
+//! * `syntect-highlighter` - Enables [`syntect`](https://docs.rs/syntect/latest/syntect/) syntax highlighting support via the [`SyntectHighlighter`]
+//!
+
+use std::{ops::Deref, sync::Arc};
+
+use crate::SpanContents;
+use owo_colors::Styled;
+
+#[cfg(feature = "syntect-highlighter")]
+pub use self::syntect::*;
+pub use blank::*;
+
+mod blank;
+#[cfg(feature = "syntect-highlighter")]
+mod syntect;
+
+/// A syntax highlighter for highlighting miette [`SourceCode`](crate::SourceCode) snippets.
+pub trait Highlighter {
+    ///  Creates a new [HighlighterState] to begin parsing and highlighting
+    /// a [SpanContents].
+    ///
+    /// The [GraphicalReportHandler](crate::GraphicalReportHandler) will call
+    /// this method at the start of rendering a [SpanContents].
+    ///
+    /// The [SpanContents] is provided as input only so that the [Highlighter]
+    /// can detect language syntax and make other initialization decisions prior
+    /// to highlighting, but it is not intended that the Highlighter begin
+    /// highlighting at this point. The returned [HighlighterState] is
+    /// responsible for the actual rendering.
+    fn start_highlighter_state<'h>(
+        &'h self,
+        source: &dyn SpanContents<'_>,
+    ) -> Box<dyn HighlighterState + 'h>;
+}
+
+/// A stateful highlighter that incrementally highlights lines of a particular
+/// source code.
+///
+/// The [GraphicalReportHandler](crate::GraphicalReportHandler)
+/// will create a highlighter state by calling
+/// [start_highlighter_state](Highlighter::start_highlighter_state) at the
+/// start of rendering, then it will iteratively call
+/// [highlight_line](HighlighterState::highlight_line) to render individual
+/// highlighted lines. This allows [Highlighter] implementations to maintain
+/// mutable parsing and highlighting state.
+pub trait HighlighterState {
+    /// Highlight an individual line from the source code by returning a vector of [Styled]
+    /// regions.
+    fn highlight_line<'s>(&mut self, line: &'s str) -> Vec<Styled<&'s str>>;
+}
+
+/// Arcified trait object for Highlighter. Used internally by [GraphicalReportHandler]
+///
+/// Wrapping the trait object in this way allows us to implement Debug and Clone.
+#[derive(Clone)]
+#[repr(transparent)]
+pub(crate) struct MietteHighlighter(Arc<dyn Highlighter + Send + Sync>);
+
+impl MietteHighlighter {
+    pub(crate) fn nocolor() -> Self {
+        Self::from(BlankHighlighter)
+    }
+
+    #[cfg(feature = "syntect-highlighter")]
+    pub(crate) fn syntect_truecolor() -> Self {
+        Self::from(SyntectHighlighter::default())
+    }
+}
+
+impl Default for MietteHighlighter {
+    #[cfg(feature = "syntect-highlighter")]
+    fn default() -> Self {
+        use is_terminal::IsTerminal;
+        match std::env::var("NO_COLOR") {
+            _ if !std::io::stdout().is_terminal() || !std::io::stderr().is_terminal() => {
+                //TODO: should use ANSI styling instead of 24-bit truecolor here
+                Self(Arc::new(SyntectHighlighter::default()))
+            }
+            Ok(string) if string != "0" => MietteHighlighter::nocolor(),
+            _ => Self(Arc::new(SyntectHighlighter::default())),
+        }
+    }
+    #[cfg(not(feature = "syntect-highlighter"))]
+    fn default() -> Self {
+        return MietteHighlighter::nocolor();
+    }
+}
+
+impl<T: Highlighter + Send + Sync + 'static> From<T> for MietteHighlighter {
+    fn from(value: T) -> Self {
+        Self(Arc::new(value))
+    }
+}
+
+impl std::fmt::Debug for MietteHighlighter {
+    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
+        write!(f, "MietteHighlighter(...)")
+    }
+}
+
+impl Deref for MietteHighlighter {
+    type Target = dyn Highlighter + Send + Sync;
+    fn deref(&self) -> &Self::Target {
+        &*self.0
+    }
+}
diff --git a/src/highlighters/syntect.rs b/src/highlighters/syntect.rs
new file mode 100644
index 0000000..57ebadf
--- /dev/null
+++ b/src/highlighters/syntect.rs
@@ -0,0 +1,170 @@
+use std::path::Path;
+
+// all syntect imports are explicitly qualified, but their paths are shortened for convenience
+mod syntect {
+    pub(super) use syntect::{
+        highlighting::{
+            Color, HighlightIterator, HighlightState, Highlighter, Style, Theme, ThemeSet,
+        },
+        parsing::{ParseState, ScopeStack, SyntaxReference, SyntaxSet},
+    };
+}
+
+use owo_colors::{Rgb, Style, Styled};
+
+use crate::{
+    highlighters::{Highlighter, HighlighterState},
+    SpanContents,
+};
+
+use super::BlankHighlighterState;
+
+/// Highlights miette [SourceCode] with the [syntect](https://docs.rs/syntect/latest/syntect/) highlighting crate.
+///
+/// Currently only 24-bit truecolor output is supported due to syntect themes
+/// representing color as RGBA.
+#[derive(Debug, Clone)]
+pub struct SyntectHighlighter {
+    theme: syntect::Theme,
+    syntax_set: syntect::SyntaxSet,
+    use_bg_color: bool,
+}
+
+impl Default for SyntectHighlighter {
+    fn default() -> Self {
+        let theme_set = syntect::ThemeSet::load_defaults();
+        let theme = theme_set.themes["base16-ocean.dark"].clone();
+        Self::new_themed(theme, false)
+    }
+}
+
+impl Highlighter for SyntectHighlighter {
+    fn start_highlighter_state<'h>(
+        &'h self,
+        source: &dyn SpanContents<'_>,
+    ) -> Box<dyn HighlighterState + 'h> {
+        if let Some(syntax) = self.detect_syntax(source) {
+            let highlighter = syntect::Highlighter::new(&self.theme);
+            let parse_state = syntect::ParseState::new(syntax);
+            let highlight_state =
+                syntect::HighlightState::new(&highlighter, syntect::ScopeStack::new());
+            Box::new(SyntectHighlighterState {
+                syntax_set: &self.syntax_set,
+                highlighter,
+                parse_state,
+                highlight_state,
+                use_bg_color: self.use_bg_color,
+            })
+        } else {
+            Box::new(BlankHighlighterState)
+        }
+    }
+}
+
+impl SyntectHighlighter {
+    /// Create a syntect highlighter with the given theme and syntax set.
+    pub fn new(syntax_set: syntect::SyntaxSet, theme: syntect::Theme, use_bg_color: bool) -> Self {
+        Self {
+            theme,
+            syntax_set,
+            use_bg_color,
+        }
+    }
+
+    /// Create a syntect highlighter with the given theme and the default syntax set.
+    pub fn new_themed(theme: syntect::Theme, use_bg_color: bool) -> Self {
+        Self::new(
+            syntect::SyntaxSet::load_defaults_nonewlines(),
+            theme,
+            use_bg_color,
+        )
+    }
+
+    /// Determine syntect SyntaxReference to use for given SourceCode
+    fn detect_syntax(&self, contents: &dyn SpanContents<'_>) -> Option<&syntect::SyntaxReference> {
+        // use language if given
+        if let Some(language) = contents.language() {
+            return self.syntax_set.find_syntax_by_name(language);
+        }
+        // otherwise try to use any file extension provided in the name
+        if let Some(name) = contents.name() {
+            if let Some(ext) = Path::new(name).extension() {
+                return self
+                    .syntax_set
+                    .find_syntax_by_extension(ext.to_string_lossy().as_ref());
+            }
+        }
+        // finally, attempt to guess syntax based on first line
+        return self.syntax_set.find_syntax_by_first_line(
+            &std::str::from_utf8(contents.data())
+                .ok()?
+                .split('\n')
+                .next()?,
+        );
+    }
+}
+
+/// Stateful highlighting iterator for [SyntectHighlighter]
+#[derive(Debug)]
+pub(crate) struct SyntectHighlighterState<'h> {
+    syntax_set: &'h syntect::SyntaxSet,
+    highlighter: syntect::Highlighter<'h>,
+    parse_state: syntect::ParseState,
+    highlight_state: syntect::HighlightState,
+    use_bg_color: bool,
+}
+
+impl<'h> HighlighterState for SyntectHighlighterState<'h> {
+    fn highlight_line<'s>(&mut self, line: &'s str) -> Vec<Styled<&'s str>> {
+        if let Ok(ops) = self.parse_state.parse_line(line, &self.syntax_set) {
+            let use_bg_color = self.use_bg_color;
+            syntect::HighlightIterator::new(
+                &mut self.highlight_state,
+                &ops,
+                line,
+                &mut self.highlighter,
+            )
+            .map(|(style, str)| (convert_style(style, use_bg_color).style(str)))
+            .collect()
+        } else {
+            vec![Style::default().style(line)]
+        }
+    }
+}
+
+/// Convert syntect [syntect::Style] into owo_colors [Style] */
+#[inline]
+fn convert_style(syntect_style: syntect::Style, use_bg_color: bool) -> Style {
+    if use_bg_color {
+        let fg = blend_fg_color(syntect_style);
+        let bg = convert_color(syntect_style.background);
+        Style::new().color(fg).on_color(bg)
+    } else {
+        let fg = convert_color(syntect_style.foreground);
+        Style::new().color(fg)
+    }
+}
+
+/// Blend foreground RGB into background RGB according to alpha channel
+#[inline]
+fn blend_fg_color(syntect_style: syntect::Style) -> Rgb {
+    let fg = syntect_style.foreground;
+    if fg.a == 0xff {
+        return convert_color(fg);
+    }
+    let bg = syntect_style.background;
+    let ratio = fg.a as u32;
+    let r = (fg.r as u32 * ratio + bg.r as u32 * (255 - ratio)) / 255;
+    let g = (fg.g as u32 * ratio + bg.g as u32 * (255 - ratio)) / 255;
+    let b = (fg.b as u32 * ratio + bg.b as u32 * (255 - ratio)) / 255;
+    Rgb(r as u8, g as u8, b as u8)
+}
+
+/// Convert syntect color into owo color.
+///
+/// Note: ignores alpha channel. use [`blend_fg_color`] if you need that
+///
+#[inline]
+fn convert_color(color: syntect::Color) -> Rgb {
+    Rgb(color.r, color.g, color.b)
+}
diff --git a/src/lib.rs b/src/lib.rs
index 862e242..f8d92f4 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -47,6 +47,7 @@
 //!   - [... delayed source code](#-delayed-source-code)
 //!   - [... handler options](#-handler-options)
 //!   - [... dynamic diagnostics](#-dynamic-diagnostics)
+//!   - [... syntax highlighting](#-syntax-highlighting)
 //! - [Acknowledgements](#acknowledgements)
 //! - [License](#license)
 //!
@@ -643,6 +644,34 @@
 //! println!("{:?}", report)
 //! ```
 //!
+//! ### ... syntax highlighting
+//!
+//! `miette` can be configured to highlight syntax in source code snippets.
+//!
+//! <!-- TODO: screenshot goes here once default Theme is decided -->
+//!
+//! To use the built-in highlighting functionality, you must enable the
+//! `syntect-highlighter` crate feature. When this feature is enabled, `miette` will
+//! automatically use the [`syntect`] crate to highlight the `#[source_code]`
+//! field of your [`Diagnostic`].
+//!
+//! Syntax detection with [`syntect`] is handled by checking 2 methods on the [`SpanContents`] trait, in order:
+//! * [language()](SpanContents::language) - Provides the name of the language
+//!   as a string. For example `"Rust"` will indicate Rust syntax highlighting.
+//!   You can set the language of the [`SpanContents`] produced by a
+//!   [`NamedSource`] via the [`with_language`](NamedSource::with_language)
+//!   method.
+//! * [name()](SpanContents::name) - In the absence of an explicitly set
+//!   language, the name is assumed to contain a file name or file path.
+//!   The highlighter will check for a file extension at the end of the name and
+//!   try to guess the syntax from that.
+//!
+//! If you want to use a custom highlighter, you can provide a custom
+//! implementation of the [`Highlighter`](highlighters::Highlighter)
+//! trait to [`MietteHandlerOpts`] by calling the
+//! [`with_syntax_highlighting`](MietteHandlerOpts::with_syntax_highlighting)
+//! method. See the [`highlighters`] module docs for more details.
+//!
 //! ## Acknowledgements
 //!
 //! `miette` was not developed in a void. It owes enormous credit to various
@@ -691,6 +720,8 @@ mod eyreish;
 #[cfg(feature = "fancy-no-backtrace")]
 mod handler;
 mod handlers;
+#[cfg(feature = "fancy-no-backtrace")]
+pub mod highlighters;
 #[doc(hidden)]
 pub mod macro_helpers;
 mod miette_diagnostic;
diff --git a/src/named_source.rs b/src/named_source.rs
index 8b0b75a..99e74a8 100644
--- a/src/named_source.rs
+++ b/src/named_source.rs
@@ -6,13 +6,15 @@ use crate::{MietteError, MietteSpanContents, SourceCode, SpanContents};
 pub struct NamedSource<S: SourceCode + 'static> {
     source: S,
     name: String,
+    language: Option<String>,
 }
 
 impl<S: SourceCode> std::fmt::Debug for NamedSource<S> {
     fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
         f.debug_struct("NamedSource")
             .field("name", &self.name)
-            .field("source", &"<redacted>");
+            .field("source", &"<redacted>")
+            .field("language", &self.language);
         Ok(())
     }
 }
@@ -27,6 +29,7 @@ impl<S: SourceCode + 'static> NamedSource<S> {
         Self {
             source,
             name: name.as_ref().to_string(),
+            language: None,
         }
     }
 
@@ -40,6 +43,12 @@ impl<S: SourceCode + 'static> NamedSource<S> {
     pub fn inner(&self) -> &S {
         &self.source
     }
+
+    /// Sets the [`language`](SpanContents::language) for this source code.
+    pub fn with_language(mut self, language: impl Into<String>) -> Self {
+        self.language = Some(language.into());
+        self
+    }
 }
 
 impl<S: SourceCode + 'static> SourceCode for NamedSource<S> {
@@ -49,16 +58,20 @@ impl<S: SourceCode + 'static> SourceCode for NamedSource<S> {
         context_lines_before: usize,
         context_lines_after: usize,
     ) -> Result<Box<dyn SpanContents<'a> + 'a>, MietteError> {
-        let contents = self
-            .inner()
-            .read_span(span, context_lines_before, context_lines_after)?;
-        Ok(Box::new(MietteSpanContents::new_named(
+        let inner_contents =
+            self.inner()
+                .read_span(span, context_lines_before, context_lines_after)?;
+        let mut contents = MietteSpanContents::new_named(
             self.name.clone(),
-            contents.data(),
-            *contents.span(),
-            contents.line(),
-            contents.column(),
-            contents.line_count(),
-        )))
+            inner_contents.data(),
+            *inner_contents.span(),
+            inner_contents.line(),
+            inner_contents.column(),
+            inner_contents.line_count(),
+        );
+        if let Some(language) = &self.language {
+            contents = contents.with_language(language);
+        }
+        Ok(Box::new(contents))
     }
 }
diff --git a/src/protocol.rs b/src/protocol.rs
index b403494..042526e 100644
--- a/src/protocol.rs
+++ b/src/protocol.rs
@@ -433,6 +433,15 @@ pub trait SpanContents<'a> {
     fn column(&self) -> usize;
     /// Total number of lines covered by this `SpanContents`.
     fn line_count(&self) -> usize;
+
+    /// Optional method. The language name for this source code, if any.
+    /// This is used to drive syntax highlighting.
+    ///
+    /// Examples: Rust, TOML, C
+    ///
+    fn language(&self) -> Option<&str> {
+        None
+    }
 }
 
 /**
@@ -452,6 +461,8 @@ pub struct MietteSpanContents<'a> {
     line_count: usize,
     // Optional filename
     name: Option<String>,
+    // Optional language
+    language: Option<String>,
 }
 
 impl<'a> MietteSpanContents<'a> {
@@ -470,6 +481,7 @@ impl<'a> MietteSpanContents<'a> {
             column,
             line_count,
             name: None,
+            language: None,
         }
     }
 
@@ -489,8 +501,15 @@ impl<'a> MietteSpanContents<'a> {
             column,
             line_count,
             name: Some(name),
+            language: None,
         }
     }
+
+    /// Sets the [`language`](SourceCode::language) for syntax highlighting.
+    pub fn with_language(mut self, language: impl Into<String>) -> Self {
+        self.language = Some(language.into());
+        self
+    }
 }
 
 impl<'a> SpanContents<'a> for MietteSpanContents<'a> {
@@ -512,6 +531,9 @@ impl<'a> SpanContents<'a> for MietteSpanContents<'a> {
     fn name(&self) -> Option<&str> {
         self.name.as_deref()
     }
+    fn language(&self) -> Option<&str> {
+        self.language.as_deref()
+    }
 }
 
 /// Span within a [`SourceCode`]
diff --git a/tests/graphical.rs b/tests/graphical.rs
index ffb701c..ac9ec10 100644
--- a/tests/graphical.rs
+++ b/tests/graphical.rs
@@ -21,12 +21,14 @@ fn fmt_report(diag: Report) -> String {
             .unwrap();
     } else if let Ok(w) = std::env::var("REPLACE_TABS") {
         GraphicalReportHandler::new_themed(GraphicalTheme::unicode_nocolor())
+            .without_syntax_highlighting()
             .with_width(80)
             .tab_width(w.parse().expect("Invalid tab width."))
             .render_report(&mut out, diag.as_ref())
             .unwrap();
     } else {
         GraphicalReportHandler::new_themed(GraphicalTheme::unicode_nocolor())
+            .without_syntax_highlighting()
             .with_width(80)
             .render_report(&mut out, diag.as_ref())
             .unwrap();
@@ -1758,6 +1760,102 @@ fn single_line_with_wide_char_unaligned_span_empty() -> Result<(), MietteError>
     Ok(())
 }
 
+#[test]
+#[cfg(feature = "syntect-highlighter")]
+fn syntax_highlighter() {
+    std::env::set_var("REPLACE_TABS", "4");
+    #[derive(Debug, Error, Diagnostic)]
+    #[error("This is an error")]
+    #[diagnostic()]
+    pub struct Test {
+        #[source_code]
+        src: NamedSource,
+        #[label("this is a label")]
+        src_span: SourceSpan,
+    }
+    let src = NamedSource::new(
+        "hello_world", //NOTE: intentionally missing file extension
+        "fn main() {\n    println!(\"Hello, World!\");\n}\n".to_string(),
+    )
+    .with_language("Rust");
+    let err = Test {
+        src,
+        src_span: (16, 26).into(),
+    };
+    let mut out = String::new();
+    GraphicalReportHandler::new_themed(GraphicalTheme::unicode())
+        .render_report(&mut out, &err)
+        .unwrap();
+    let expected = r#"  × This is an error
+   ╭─[hello_world:2:5]
+ 1 │ fn main() {
+ 2 │     println!("Hello, World!");
+   ·     ─────────────┬────────────
+   ·                  ╰── this is a label
+ 3 │ }
+   ╰────
+"#;
+    assert!(out.contains("\u{1b}[38;2;180;142;173m"));
+    assert_eq!(expected, strip_ansi_escapes::strip_str(out))
+}
+
+// This test reads a line from the current source file and renders it with Rust
+// syntax highlighting. The goal is to test syntax highlighting on a non-trivial
+// source code example. However, if tests are running in an environment where
+// source files are missing, this will cause problems. In that case, it would
+// be better to use include_str!() on a sufficiently complex example file.
+#[test]
+#[cfg(feature = "syntect-highlighter")]
+fn syntax_highlighter_on_real_file() {
+    std::env::set_var("REPLACE_TABS", "4");
+
+    #[derive(Debug, Error, Diagnostic)]
+    #[error("This is an error")]
+    #[diagnostic()]
+    pub struct Test {
+        #[source_code]
+        src: NamedSource,
+        #[label("this is a label")]
+        src_span: SourceSpan,
+    }
+    // BEGIN SOURCE SNIPPET
+
+    let (filename, line) = (file!(), line!() as usize);
+
+    // END SOURCE SNIPPET
+    // SourceSpan constants for column and length
+    const CO: usize = 28;
+    const LEN: usize = 27;
+    let file_src = std::fs::read_to_string(&filename).unwrap();
+    let offset = miette::SourceOffset::from_location(&file_src, line, CO);
+    let err = Test {
+        src: NamedSource::new(&filename, file_src.clone()),
+        src_span: SourceSpan::new(offset, LEN.into()),
+    };
+
+    let mut out = String::new();
+    GraphicalReportHandler::new_themed(GraphicalTheme::unicode())
+        .with_context_lines(1)
+        .render_report(&mut out, &err)
+        .unwrap();
+
+    let expected = format!(
+        r#"  × This is an error
+      ╭─[{filename}:{l2}:{CO}]
+ {l1} │ 
+ {l2} │     let (filename, line) = (file!(), line!() as usize);
+      ·                            ─────────────┬─────────────
+      ·                                         ╰── this is a label
+ {l3} │ 
+      ╰────
+"#,
+        l1 = line - 1,
+        l2 = line,
+        l3 = line + 1
+    );
+    assert!(out.contains("\u{1b}[38;2;180;142;173m"));
+    assert_eq!(expected, strip_ansi_escapes::strip_str(out));
+
 #[test]
 fn triple_adjacent_highlight() -> Result<(), MietteError> {
     #[derive(Debug, Diagnostic, Error)]

From e5c7ae469e40a8bc102e1fca3b8fd4b2ec137696 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kat=20March=C3=A1n?= <kzm@zkat.tech>
Date: Sat, 3 Feb 2024 19:24:07 -0800
Subject: [PATCH 34/67] feat(deps): remove is-terminal dep in favor of
 `std::io::IsTerminal`

---
 .github/workflows/ci.yml |  8 ++++----
 Cargo.toml               |  8 +++-----
 src/handlers/theme.rs    |  3 ++-
 src/protocol.rs          |  2 +-
 tests/graphical.rs       | 17 +++++++++--------
 5 files changed, 19 insertions(+), 19 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 32125cc..e6871c4 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -27,11 +27,11 @@ jobs:
     strategy:
       matrix:
         features: [fancy, syntect-highlighter]
-        rust: [1.56.0, stable]
+        rust: [1.70.0, stable]
         os: [ubuntu-latest, macOS-latest, windows-latest]
         exclude:
           - features: syntect-highlighter
-            rust: 1.56.0
+            rust: 1.70.0
 
     steps:
       - uses: actions/checkout@v4
@@ -41,7 +41,7 @@ jobs:
           toolchain: ${{ matrix.rust }}
           components: clippy
       - name: Force older version of is-terminal for MSRV builds
-        if: matrix.rust == '1.56.0'
+        if: matrix.rust == '1.70.0'
         run:  cargo update -p is-terminal --precise 0.4.7
       - name: Clippy
         run: cargo clippy --all -- -D warnings
@@ -49,7 +49,7 @@ jobs:
         if: matrix.rust == 'stable'
         run: cargo test --all --verbose --features ${{matrix.features}}
       - name: Run tests
-        if: matrix.rust == '1.56.0'
+        if: matrix.rust == '1.70.0'
         run: cargo test --all --verbose --features ${{matrix.features}} no-format-args-capture
 
   miri:
diff --git a/Cargo.toml b/Cargo.toml
index 0123cc0..7567d95 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -19,11 +19,10 @@ once_cell = "1.8.0"
 unicode-width = "0.1.9"
 
 owo-colors = { version = "3.4.0", optional = true }
-is-terminal = { version = "0.4.0", optional = true }
 textwrap = { version = "0.15.0", optional = true }
-supports-hyperlinks = { version = "2.0.0", optional = true }
-supports-color = { version = "2.0.0", optional = true }
-supports-unicode = { version = "2.0.0", optional = true }
+supports-hyperlinks = { version = "3.0.0", optional = true }
+supports-color = { version = "3.0.0", optional = true }
+supports-unicode = { version = "3.0.0", optional = true }
 backtrace = { version = "0.3.61", optional = true }
 terminal_size = { version = "0.3.0", optional = true }
 backtrace-ext = { version = "0.2.1", optional = true }
@@ -51,7 +50,6 @@ derive = ["miette-derive"]
 no-format-args-capture = []
 fancy-no-backtrace = [
     "owo-colors",
-    "is-terminal",
     "textwrap",
     "terminal_size",
     "supports-hyperlinks",
diff --git a/src/handlers/theme.rs b/src/handlers/theme.rs
index aa6649e..892ffc2 100644
--- a/src/handlers/theme.rs
+++ b/src/handlers/theme.rs
@@ -1,4 +1,5 @@
-use is_terminal::IsTerminal;
+use std::io::IsTerminal;
+
 use owo_colors::Style;
 
 /**
diff --git a/src/protocol.rs b/src/protocol.rs
index 042526e..8ca719d 100644
--- a/src/protocol.rs
+++ b/src/protocol.rs
@@ -257,7 +257,7 @@ impl LabeledSpan {
     pub const fn new(label: Option<String>, offset: ByteOffset, len: usize) -> Self {
         Self {
             label,
-            span: SourceSpan::new(SourceOffset(offset), SourceOffset(len)),
+            span: SourceSpan::new(SourceOffset(offset), len),
             primary: false,
         }
     }
diff --git a/tests/graphical.rs b/tests/graphical.rs
index ac9ec10..86d79e1 100644
--- a/tests/graphical.rs
+++ b/tests/graphical.rs
@@ -1842,11 +1842,11 @@ fn syntax_highlighter_on_real_file() {
     let expected = format!(
         r#"  × This is an error
       ╭─[{filename}:{l2}:{CO}]
- {l1} │ 
+ {l1} │
  {l2} │     let (filename, line) = (file!(), line!() as usize);
       ·                            ─────────────┬─────────────
       ·                                         ╰── this is a label
- {l3} │ 
+ {l3} │
       ╰────
 "#,
         l1 = line - 1,
@@ -1855,6 +1855,7 @@ fn syntax_highlighter_on_real_file() {
     );
     assert!(out.contains("\u{1b}[38;2;180;142;173m"));
     assert_eq!(expected, strip_ansi_escapes::strip_str(out));
+  }
 
 #[test]
 fn triple_adjacent_highlight() -> Result<(), MietteError> {
@@ -1888,13 +1889,13 @@ fn triple_adjacent_highlight() -> Result<(), MietteError> {
  1 │ source
    · ───┬──
    ·    ╰── this bit here
- 2 │ 
- 3 │ 
+ 2 │
+ 3 │
  4 │   text
    ·   ──┬─
    ·     ╰── also this bit
- 5 │ 
- 6 │ 
+ 5 │
+ 6 │
  7 │     here
    ·     ──┬─
    ·       ╰── finally we got
@@ -1934,10 +1935,10 @@ fn non_adjacent_highlight() -> Result<(), MietteError> {
  1 │ source
    · ───┬──
    ·    ╰── this bit here
- 2 │ 
+ 2 │
    ╰────
    ╭─[bad_file.rs:5:3]
- 4 │ 
+ 4 │
  5 │   text    here
    ·   ──┬─
    ·     ╰── also this bit

From 4c48584f304414c6924bede3308b455cfef60749 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kat=20March=C3=A1n?= <kzm@zkat.tech>
Date: Sat, 3 Feb 2024 19:29:28 -0800
Subject: [PATCH 35/67] feat(deps): remove once_cell dep in favor of
 `std::sync::OnceLock`

BREAKING CHANGE: This requires an MSRV bump to 1.70.0.
---
 Cargo.toml         | 1 -
 src/eyreish/mod.rs | 5 ++---
 2 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/Cargo.toml b/Cargo.toml
index 7567d95..4833e59 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -15,7 +15,6 @@ exclude = ["images/", "tests/", "miette-derive/"]
 [dependencies]
 thiserror = "1.0.40"
 miette-derive = { path = "miette-derive", version = "=5.10.0", optional = true }
-once_cell = "1.8.0"
 unicode-width = "0.1.9"
 
 owo-colors = { version = "3.4.0", optional = true }
diff --git a/src/eyreish/mod.rs b/src/eyreish/mod.rs
index 0efceed..0dfd878 100644
--- a/src/eyreish/mod.rs
+++ b/src/eyreish/mod.rs
@@ -7,8 +7,7 @@
 use core::fmt::Display;
 
 use std::error::Error as StdError;
-
-use once_cell::sync::OnceCell;
+use std::sync::OnceLock;
 
 #[allow(unreachable_pub)]
 pub use into_diagnostic::*;
@@ -62,7 +61,7 @@ unsafe impl Send for Report {}
 pub type ErrorHook =
     Box<dyn Fn(&(dyn Diagnostic + 'static)) -> Box<dyn ReportHandler> + Sync + Send + 'static>;
 
-static HOOK: OnceCell<ErrorHook> = OnceCell::new();
+static HOOK: OnceLock<ErrorHook> = OnceLock::new();
 
 /// Error indicating that [`set_hook()`] was unable to install the provided
 /// [`ErrorHook`].

From 29d000f201b259a056867a2876384f97653a6e9e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kat=20March=C3=A1n?= <kzm@zkat.tech>
Date: Sat, 3 Feb 2024 19:35:52 -0800
Subject: [PATCH 36/67] feat(deps): bump some semver-breaking deps to newer
 versions

---
 Cargo.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Cargo.toml b/Cargo.toml
index 4833e59..cbf357a 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -18,7 +18,7 @@ miette-derive = { path = "miette-derive", version = "=5.10.0", optional = true }
 unicode-width = "0.1.9"
 
 owo-colors = { version = "3.4.0", optional = true }
-textwrap = { version = "0.15.0", optional = true }
+textwrap = { version = "0.16.0", optional = true }
 supports-hyperlinks = { version = "3.0.0", optional = true }
 supports-color = { version = "3.0.0", optional = true }
 supports-unicode = { version = "3.0.0", optional = true }

From ab59a7bc9bceace5761a862ee2ebff3e5943b12f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kat=20March=C3=A1n?= <kzm@zkat.tech>
Date: Sat, 3 Feb 2024 19:44:46 -0800
Subject: [PATCH 37/67] feat(MSRV): Actually bump the MSRV to 1.70.0

---
 Cargo.toml      |  2 +-
 README.md       | 42 ++++++++++++++++++++++++++++++++++++++----
 clippy.toml     |  2 +-
 src/lib.rs      |  4 ++++
 src/protocol.rs |  8 +++-----
 5 files changed, 47 insertions(+), 11 deletions(-)

diff --git a/Cargo.toml b/Cargo.toml
index cbf357a..15c83e7 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -9,7 +9,7 @@ documentation = "https://docs.rs/miette"
 license = "Apache-2.0"
 readme = "README.md"
 edition = "2018"
-rust-version = "1.56.0"
+rust-version = "1.70.0"
 exclude = ["images/", "tests/", "miette-derive/"]
 
 [dependencies]
diff --git a/README.md b/README.md
index 8af2845..0e936b3 100644
--- a/README.md
+++ b/README.md
@@ -48,6 +48,7 @@ libraries and such might not want.
   - [... delayed source code](#-delayed-source-code)
   - [... handler options](#-handler-options)
   - [... dynamic diagnostics](#-dynamic-diagnostics)
+  - [... syntax highlighting](#-syntax-highlighting)
 - [Acknowledgements](#acknowledgements)
 - [License](#license)
 
@@ -96,7 +97,7 @@ You can derive a `Diagnostic` from any `std::error::Error` type.
 
 `thiserror` is a great way to define them, and plays nicely with `miette`!
 */
-use miette::{Diagnostic, NamedSource, SourceSpan};
+use miette::{Diagnostic, SourceSpan};
 use thiserror::Error;
 
 #[derive(Error, Debug, Diagnostic)]
@@ -123,7 +124,7 @@ Use this `Result` type (or its expanded version) as the return type
 throughout your app (but NOT your libraries! Those should always return
 concrete types!).
 */
-use miette::Result;
+use miette::{NamedSource, Result};
 fn this_fails() -> Result<()> {
     // You can use plain strings as a `Source`, or anything that implements
     // the one-method `Source` trait.
@@ -305,7 +306,7 @@ enabled:
 miette = { version = "X.Y.Z", features = ["fancy"] }
 ```
 
-Another way to display a diagnostic is by printing them using the debug formatter. 
+Another way to display a diagnostic is by printing them using the debug formatter.
 This is, in fact, what returning diagnostics from main ends up doing.
 To do it yourself, you can write the following:
 
@@ -611,6 +612,7 @@ miette::set_hook(Box::new(|_| {
             .unicode(false)
             .context_lines(3)
             .tab_width(4)
+            .break_words(true)
             .build(),
     )
 }))
@@ -632,7 +634,7 @@ then you may want to use [`miette!`], [`diagnostic!`] macros or
 
 let source = "2 + 2 * 2 = 8".to_string();
 let report = miette!(
-  labels = vec![
+  labels = vec[
       LabeledSpan::at(12..13, "this should be 6"),
   ],
   help = "'*' has greater precedence than '+'",
@@ -641,6 +643,38 @@ let report = miette!(
 println!("{:?}", report)
 ```
 
+#### ... syntax highlighting
+
+`miette` can be configured to highlight syntax in source code snippets.
+
+<!-- TODO: screenshot goes here once default Theme is decided -->
+
+To use the built-in highlighting functionality, you must enable the
+`syntect-highlighter` crate feature. When this feature is enabled, `miette` will
+automatically use the [`syntect`] crate to highlight the `#[source_code]`
+field of your [`Diagnostic`].
+
+Syntax detection with [`syntect`] is handled by checking 2 methods on the [`SpanContents`] trait, in order:
+* [language()](SpanContents::language) - Provides the name of the language
+  as a string. For example `"Rust"` will indicate Rust syntax highlighting.
+  You can set the language of the [`SpanContents`] produced by a
+  [`NamedSource`] via the [`with_language`](NamedSource::with_language)
+  method.
+* [name()](SpanContents::name) - In the absence of an explicitly set
+  language, the name is assumed to contain a file name or file path.
+  The highlighter will check for a file extension at the end of the name and
+  try to guess the syntax from that.
+
+If you want to use a custom highlighter, you can provide a custom
+implementation of the [`Highlighter`](highlighters::Highlighter)
+trait to [`MietteHandlerOpts`] by calling the
+[`with_syntax_highlighting`](MietteHandlerOpts::with_syntax_highlighting)
+method. See the [`highlighters`] module docs for more details.
+
+### MSRV
+
+This crate requires rustc 1.70.0 or later.
+
 ### Acknowledgements
 
 `miette` was not developed in a void. It owes enormous credit to various
diff --git a/clippy.toml b/clippy.toml
index 0d369b5..1645c19 100644
--- a/clippy.toml
+++ b/clippy.toml
@@ -1 +1 @@
-msrv = "1.56.0"
+msrv = "1.70.0"
diff --git a/src/lib.rs b/src/lib.rs
index f8d92f4..7674f2b 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -672,6 +672,10 @@
 //! [`with_syntax_highlighting`](MietteHandlerOpts::with_syntax_highlighting)
 //! method. See the [`highlighters`] module docs for more details.
 //!
+//! ## MSRV
+//!
+//! This crate requires rustc 1.70.0 or later.
+//!
 //! ## Acknowledgements
 //!
 //! `miette` was not developed in a void. It owes enormous credit to various
diff --git a/src/protocol.rs b/src/protocol.rs
index 8ca719d..4c0101f 100644
--- a/src/protocol.rs
+++ b/src/protocol.rs
@@ -179,6 +179,7 @@ impl From<Box<dyn std::error::Error + Send + Sync>> for Box<dyn Diagnostic + Sen
 */
 #[derive(Copy, Clone, Debug, Eq, Ord, PartialEq, PartialOrd)]
 #[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
+#[derive(Default)]
 pub enum Severity {
     /// Just some help. Here's how you could be doing it better.
     Advice,
@@ -186,14 +187,11 @@ pub enum Severity {
     Warning,
     /// Critical failure. The program cannot continue.
     /// This is the default severity, if you don't specify another one.
+    #[default]
     Error,
 }
 
-impl Default for Severity {
-    fn default() -> Self {
-        Severity::Error
-    }
-}
+
 
 #[cfg(feature = "serde")]
 #[test]

From 52b32403861ddb5d1aad916ee4e1a8b061c972c4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kat=20March=C3=A1n?= <kzm@zkat.tech>
Date: Sat, 3 Feb 2024 20:01:25 -0800
Subject: [PATCH 38/67] docs: update changelog

---
 CHANGELOG.md | 49 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 955c27d..f0bfcad 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,54 @@
 # `miette` Release Changelog
 
+<a name="6.0.0"></a>
+## 6.0.0 (2024-02-04)
+
+The long-awaited 6.0 release of `miette` is here, with TONS of goodies, not
+least of which is syntax highlighting support!
+
+It also comes with a few breaking changes so make sure to check below and
+update your code as needed!
+
+### Features
+
+* **labels:** Add support for primary label in specifying line/col information (#291) ([db0b7e40](https://github.com/zkat/miette/commit/db0b7e403a5ae52ae360991b6508490d8c579886))
+* **derive:** Allow optional sources in derive (#301) ([88d00e0e](https://github.com/zkat/miette/commit/88d00e0e20bf95e03b8f81dcd5adf38c917e190e))
+* **derive:** Make `miette-derive` be able to be turned off (#304) ([c7ba5b7e](https://github.com/zkat/miette/commit/c7ba5b7e52e05991cecd3ca925c710bbe49850b9))
+* **graphical:** Expose additional `textwrap` options (#321) ([fd77257c](https://github.com/zkat/miette/commit/fd77257cee0f5d03aa7dccb4ba8cbaa40c1a88c6))
+* **graphical:** support rendering labels that contain newlines (#318) ([865d67c8](https://github.com/zkat/miette/commit/865d67c8dda119ddd03ac43be22f4fa272a9f433))
+* **graphical:** Add `wrap_lines: bool` option allowing wrapping be disabled entirely (#328) ([b0744462](https://github.com/zkat/miette/commit/b0744462adbbfbb6d845f382db36be883c7f3c45))
+* **graphical:** render disjoint snippets separately for cleaner output (#324) ([19c22143](https://github.com/zkat/miette/commit/19c22143cb544616046784e35c5e78cc5b881289))
+* **deps:** Bump terminal-size to v0.3.0 (#308) ([c0a298e5](https://github.com/zkat/miette/commit/c0a298e5a8d699acf9fcd61b5d5fa4f6279a47ab))
+    * **BREAKING CHANGE**: This requires an MSRV bump to 1.70.0.
+* **source-code:** Don't override provided source code (#300) ([0d5c2ce7](https://github.com/zkat/miette/commit/0d5c2ce7536b0ea205346595d8a00d00bfb6cbd2))
+    * **BREAKING CHANGE**: Source code is no longer overridden if it was provided by the diagnostic's own `source_code()` impl.
+* **source:** use `usize` for length (#265) ([fad0e76a](https://github.com/zkat/miette/commit/fad0e76ad2e19d5cac13cf8324338aca0d623d93))
+    * **BREAKING CHANGE**: This changes `SourceSpan`'s length type to `usize`.
+* **source:** Allow inner source type of a NamedSource to be borrowed (#254) ([1df3b1a5](https://github.com/zkat/miette/commit/1df3b1a537f2e54cd40ec45f5cd851337a22e95a))
+    * **BREAKING CHANGE**: This makes the `NamedSource` type generic over its `Source` type, instead of boxing it.
+* **highlighting:** add syntax highlighting support with syntect crate (#313) ([e65d0a78](https://github.com/zkat/miette/commit/e65d0a78cc639653f061a45d8ce35b1a3551ade7))
+* **deps:** remove is-terminal dep in favor of `std::io::IsTerminal` ([e5c7ae46](https://github.com/zkat/miette/commit/e5c7ae469e40a8bc102e1fca3b8fd4b2ec137696))
+* **deps:** remove once_cell dep in favor of `std::sync::OnceLock` ([4c48584f](https://github.com/zkat/miette/commit/4c48584f304414c6924bede3308b455cfef60749))
+    * **BREAKING CHANGE**: This requires an MSRV bump to 1.70.0.
+* **deps:** bump some semver-breaking deps to newer versions ([29d000f2](https://github.com/zkat/miette/commit/29d000f201b259a056867a2876384f97653a6e9e))
+* **MSRV:** Actually bump the MSRV to 1.70.0 ([ab59a7bc](https://github.com/zkat/miette/commit/ab59a7bc9bceace5761a862ee2ebff3e5943b12f))
+
+### Bug Fixes
+
+* **misc:** Improve ci and fix clippy (#290) ([cc81382a](https://github.com/zkat/miette/commit/cc81382a6070dd226a20e4a39518d88e957ac0e1))
+* **tests:** Fix `cargo test` with default features. (#294) ([1f448e47](https://github.com/zkat/miette/commit/1f448e47751d0f914134b0e9138fdb1a5a95d55c))
+* **clippy:** Add missing semicolons where nothing is returned. (#293) ([06b34823](https://github.com/zkat/miette/commit/06b348230aaf153b8b050322f05e5d185351d2d1))
+* **graphical:** Extend error text span to whole code points (#312) ([a8b4ae01](https://github.com/zkat/miette/commit/a8b4ae012aa0cf03b53a18f013c2b3f76c5040e7))
+* **formatting:** Fix formatting bug when an empty span is not aligned to a char boundary (#314) ([3d6f903d](https://github.com/zkat/miette/commit/3d6f903df0e7c9d0eb9a1fdbbf0028bab5496429))
+* **docs:** add example to README and docs fixing #96 (#319) ([251d6d59](https://github.com/zkat/miette/commit/251d6d59292397458328ef57fb7957faedafd019))
+* **graphical:** rendering bug on small spans in large spans (#316) ([7ff4f874](https://github.com/zkat/miette/commit/7ff4f874d693a665af4df40f4e94505013e3e262))
+* **graphical:** render cause chains for inner errors (#330) ([cb2ae2e1](https://github.com/zkat/miette/commit/cb2ae2e18b446a5e90885faf8a30b5672c307df8))
+* **handler:** remove the two extra `is_terminal` sys call from `MietteHandlerOpts::build` (#325) ([f1dc89c0](https://github.com/zkat/miette/commit/f1dc89c07640445d224b61ef96c6b25fcdf62dee))
+
+### Documentation
+
+* **README:** Move import of `NamedResult` to where it is used (#309) ([d37ada87](https://github.com/zkat/miette/commit/d37ada876a5831d3f47622274e334c9a24aa5d2b))
+
 <a name="5.10.0"></a>
 ## 5.10.0 (2023-07-16)
 

From 5d4b262f7b752396077e12650ebbda07acbef54b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kat=20March=C3=A1n?= <kzm@zkat.tech>
Date: Sat, 3 Feb 2024 20:01:50 -0800
Subject: [PATCH 39/67] chore: Release

---
 Cargo.toml               | 4 ++--
 miette-derive/Cargo.toml | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/Cargo.toml b/Cargo.toml
index 15c83e7..eb08466 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "miette"
-version = "5.10.0"
+version = "6.0.0"
 authors = ["Kat Marchán <kzm@zkat.tech>"]
 description = "Fancy diagnostic reporting library and protocol for us mere mortals who aren't compiler hackers."
 categories = ["rust-patterns"]
@@ -14,7 +14,7 @@ exclude = ["images/", "tests/", "miette-derive/"]
 
 [dependencies]
 thiserror = "1.0.40"
-miette-derive = { path = "miette-derive", version = "=5.10.0", optional = true }
+miette-derive = { path = "miette-derive", version = "=6.0.0", optional = true }
 unicode-width = "0.1.9"
 
 owo-colors = { version = "3.4.0", optional = true }
diff --git a/miette-derive/Cargo.toml b/miette-derive/Cargo.toml
index b5a7032..40906de 100644
--- a/miette-derive/Cargo.toml
+++ b/miette-derive/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "miette-derive"
-version = "5.10.0"
+version = "6.0.0"
 authors = ["Kat Marchán <kzm@zkat.tech>"]
 edition = "2018"
 license = "Apache-2.0"

From 95964055546384ebcb93de0ce1381f57dcbbaa90 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kat=20March=C3=A1n?= <kzm@zkat.tech>
Date: Sat, 3 Feb 2024 20:10:38 -0800
Subject: [PATCH 40/67] ci: fix is-terminal nonsense

---
 .github/workflows/ci.yml | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index e6871c4..d5f437e 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -40,9 +40,6 @@ jobs:
         with:
           toolchain: ${{ matrix.rust }}
           components: clippy
-      - name: Force older version of is-terminal for MSRV builds
-        if: matrix.rust == '1.70.0'
-        run:  cargo update -p is-terminal --precise 0.4.7
       - name: Clippy
         run: cargo clippy --all -- -D warnings
       - name: Run tests

From 8b46679c3647e1455d91b4c68743c619fb3f3eb3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kat=20March=C3=A1n?= <kzm@zkat.tech>
Date: Sat, 3 Feb 2024 20:12:46 -0800
Subject: [PATCH 41/67] fix(graphical): oops. Fix theme issue

---
 src/handler.rs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/handler.rs b/src/handler.rs
index a564f44..dcf8b13 100644
--- a/src/handler.rs
+++ b/src/handler.rs
@@ -311,8 +311,7 @@ impl MietteHandlerOpts {
             let theme = self.theme.unwrap_or(GraphicalTheme { characters, styles });
             let mut handler = GraphicalReportHandler::new_themed(theme)
                 .with_width(width)
-                .with_links(linkify)
-                .with_theme(theme);
+                .with_links(linkify);
             handler.highlighter = highlighter;
             if let Some(with_cause_chain) = self.with_cause_chain {
                 if with_cause_chain {

From 1fa7f5241fb91d2e5bad9b0e26bcc7cd5f9011f1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kat=20March=C3=A1n?= <kzm@zkat.tech>
Date: Sat, 3 Feb 2024 20:14:01 -0800
Subject: [PATCH 42/67] fix(fmt): remove nightly-only fmt flags

---
 rustfmt.toml       | 2 --
 src/protocol.rs    | 2 --
 tests/graphical.rs | 2 +-
 3 files changed, 1 insertion(+), 5 deletions(-)

diff --git a/rustfmt.toml b/rustfmt.toml
index 8f9ebdd..3a26366 100644
--- a/rustfmt.toml
+++ b/rustfmt.toml
@@ -1,3 +1 @@
 edition = "2021"
-wrap_comments = true
-format_code_in_doc_comments = true
diff --git a/src/protocol.rs b/src/protocol.rs
index 4c0101f..6b98a97 100644
--- a/src/protocol.rs
+++ b/src/protocol.rs
@@ -191,8 +191,6 @@ pub enum Severity {
     Error,
 }
 
-
-
 #[cfg(feature = "serde")]
 #[test]
 fn test_serialize_severity() {
diff --git a/tests/graphical.rs b/tests/graphical.rs
index 86d79e1..456231a 100644
--- a/tests/graphical.rs
+++ b/tests/graphical.rs
@@ -1855,7 +1855,7 @@ fn syntax_highlighter_on_real_file() {
     );
     assert!(out.contains("\u{1b}[38;2;180;142;173m"));
     assert_eq!(expected, strip_ansi_escapes::strip_str(out));
-  }
+}
 
 #[test]
 fn triple_adjacent_highlight() -> Result<(), MietteError> {

From 3747fccf8d7751191869337eed75c4a90656b144 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kat=20March=C3=A1n?= <kzm@zkat.tech>
Date: Sat, 3 Feb 2024 20:22:36 -0800
Subject: [PATCH 43/67] test: fix some fancy tests after NamedSource change

---
 tests/graphical.rs | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/tests/graphical.rs b/tests/graphical.rs
index 456231a..32e3441 100644
--- a/tests/graphical.rs
+++ b/tests/graphical.rs
@@ -304,7 +304,7 @@ fn multiple_spans_multiline() {
     #[diagnostic(severity(Error))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<&'static str>,
         #[label("big")]
         big: SourceSpan,
         #[label("small")]
@@ -824,7 +824,7 @@ fn multiline_label() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this bit here\nand\nthis\ntoo")]
         highlight: SourceSpan,
     }
@@ -864,7 +864,7 @@ fn multiple_multi_line_labels() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label = "x\ny"]
         highlight1: SourceSpan,
         #[label = "z\nw"]
@@ -1040,7 +1040,7 @@ fn multiline_highlight_multiline_label() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label = "these two lines\nare the problem"]
         highlight: SourceSpan,
     }
@@ -1620,7 +1620,7 @@ fn primary_label() {
     #[error("oops!")]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<&'static str>,
         #[label]
         first_label: SourceSpan,
         #[label(primary, "nope")]
@@ -1656,7 +1656,7 @@ fn single_line_with_wide_char_unaligned_span_start() -> Result<(), MietteError>
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this bit here")]
         highlight: SourceSpan,
     }
@@ -1693,7 +1693,7 @@ fn single_line_with_wide_char_unaligned_span_end() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this bit here")]
         highlight: SourceSpan,
     }
@@ -1730,7 +1730,7 @@ fn single_line_with_wide_char_unaligned_span_empty() -> Result<(), MietteError>
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this bit here")]
         highlight: SourceSpan,
     }
@@ -1769,7 +1769,7 @@ fn syntax_highlighter() {
     #[diagnostic()]
     pub struct Test {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this is a label")]
         src_span: SourceSpan,
     }
@@ -1814,7 +1814,7 @@ fn syntax_highlighter_on_real_file() {
     #[diagnostic()]
     pub struct Test {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label("this is a label")]
         src_span: SourceSpan,
     }
@@ -1864,7 +1864,7 @@ fn triple_adjacent_highlight() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label = "this bit here"]
         highlight1: SourceSpan,
         #[label = "also this bit"]
@@ -1913,7 +1913,7 @@ fn non_adjacent_highlight() -> Result<(), MietteError> {
     #[diagnostic(code(oops::my::bad), help("try doing it better next time?"))]
     struct MyBad {
         #[source_code]
-        src: NamedSource,
+        src: NamedSource<String>,
         #[label = "this bit here"]
         highlight1: SourceSpan,
         #[label = "also this bit"]

From ab7c066e7675d8c7ecb956000d278fc31f3bc6a1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kat=20March=C3=A1n?= <kzm@zkat.tech>
Date: Sat, 3 Feb 2024 20:25:23 -0800
Subject: [PATCH 44/67] fix(highlighter): ugh, missed another spot

---
 src/highlighters/mod.rs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/highlighters/mod.rs b/src/highlighters/mod.rs
index 47e7f7c..d605c1c 100644
--- a/src/highlighters/mod.rs
+++ b/src/highlighters/mod.rs
@@ -80,7 +80,7 @@ impl MietteHighlighter {
 impl Default for MietteHighlighter {
     #[cfg(feature = "syntect-highlighter")]
     fn default() -> Self {
-        use is_terminal::IsTerminal;
+        use std::io::IsTerminal;
         match std::env::var("NO_COLOR") {
             _ if !std::io::stdout().is_terminal() || !std::io::stderr().is_terminal() => {
                 //TODO: should use ANSI styling instead of 24-bit truecolor here

From e515a3c0ec7a51c8ac9de79e17fd9294bcaf87f9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kat=20March=C3=A1n?= <kzm@zkat.tech>
Date: Sat, 3 Feb 2024 20:27:39 -0800
Subject: [PATCH 45/67] docs: update changelog

---
 CHANGELOG.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index f0bfcad..4de742a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,14 @@
 # `miette` Release Changelog
 
+<a name="6.0.1"></a>
+## 6.0.1 (2024-02-04)
+
+### Bug Fixes
+
+* **graphical:** oops. Fix theme issue ([8b46679c](https://github.com/zkat/miette/commit/8b46679c3647e1455d91b4c68743c619fb3f3eb3))
+* **fmt:** remove nightly-only fmt flags ([1fa7f524](https://github.com/zkat/miette/commit/1fa7f5241fb91d2e5bad9b0e26bcc7cd5f9011f1))
+* **highlighter:** ugh, missed another spot ([ab7c066e](https://github.com/zkat/miette/commit/ab7c066e7675d8c7ecb956000d278fc31f3bc6a1))
+
 <a name="6.0.0"></a>
 ## 6.0.0 (2024-02-04)
 

From cf2d8c0b2c2b81567a6472185545733f2ca878f8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kat=20March=C3=A1n?= <kzm@zkat.tech>
Date: Sat, 3 Feb 2024 20:27:47 -0800
Subject: [PATCH 46/67] chore: Release

---
 Cargo.toml               | 4 ++--
 miette-derive/Cargo.toml | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/Cargo.toml b/Cargo.toml
index eb08466..450cf2d 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "miette"
-version = "6.0.0"
+version = "6.0.1"
 authors = ["Kat Marchán <kzm@zkat.tech>"]
 description = "Fancy diagnostic reporting library and protocol for us mere mortals who aren't compiler hackers."
 categories = ["rust-patterns"]
@@ -14,7 +14,7 @@ exclude = ["images/", "tests/", "miette-derive/"]
 
 [dependencies]
 thiserror = "1.0.40"
-miette-derive = { path = "miette-derive", version = "=6.0.0", optional = true }
+miette-derive = { path = "miette-derive", version = "=6.0.1", optional = true }
 unicode-width = "0.1.9"
 
 owo-colors = { version = "3.4.0", optional = true }
diff --git a/miette-derive/Cargo.toml b/miette-derive/Cargo.toml
index 40906de..7945edf 100644
--- a/miette-derive/Cargo.toml
+++ b/miette-derive/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "miette-derive"
-version = "6.0.0"
+version = "6.0.1"
 authors = ["Kat Marchán <kzm@zkat.tech>"]
 edition = "2018"
 license = "Apache-2.0"

From c7144ee513bf8f06c5f7d89c45436802994a51fc Mon Sep 17 00:00:00 2001
From: David Calavera <david.calavera@gmail.com>
Date: Sun, 4 Feb 2024 16:54:18 -0800
Subject: [PATCH 47/67] feat(fancy): Add option to change the link display text
 (#335)

This option allows to globally change the default `(link)` display text with any other text provider by users.
---
 src/handlers/graphical.rs | 13 ++++++++++++-
 tests/graphical.rs        | 22 ++++++++++++++++++++++
 2 files changed, 34 insertions(+), 1 deletion(-)

diff --git a/src/handlers/graphical.rs b/src/handlers/graphical.rs
index d7e1883..3f74227 100644
--- a/src/handlers/graphical.rs
+++ b/src/handlers/graphical.rs
@@ -36,6 +36,7 @@ pub struct GraphicalReportHandler {
     pub(crate) word_separator: Option<textwrap::WordSeparator>,
     pub(crate) word_splitter: Option<textwrap::WordSplitter>,
     pub(crate) highlighter: MietteHighlighter,
+    pub(crate) link_display_text: Option<String>,
 }
 
 #[derive(Debug, Clone, Copy, PartialEq, Eq)]
@@ -62,6 +63,7 @@ impl GraphicalReportHandler {
             word_separator: None,
             word_splitter: None,
             highlighter: MietteHighlighter::default(),
+            link_display_text: None,
         }
     }
 
@@ -80,6 +82,7 @@ impl GraphicalReportHandler {
             word_separator: None,
             word_splitter: None,
             highlighter: MietteHighlighter::default(),
+            link_display_text: None,
         }
     }
 
@@ -190,6 +193,13 @@ impl GraphicalReportHandler {
         self.highlighter = MietteHighlighter::nocolor();
         self
     }
+
+    /// Sets the display text for links.
+    /// Miette displays `(link)` if this option is not set.
+    pub fn with_link_display_text(mut self, text: impl Into<String>) -> Self {
+        self.link_display_text = Some(text.into());
+        self
+    }
 }
 
 impl Default for GraphicalReportHandler {
@@ -246,11 +256,12 @@ impl GraphicalReportHandler {
             } else {
                 "".to_string()
             };
+            let display_text = self.link_display_text.as_deref().unwrap_or("(link)");
             let link = format!(
                 "\u{1b}]8;;{}\u{1b}\\{}{}\u{1b}]8;;\u{1b}\\",
                 url,
                 code.style(severity_style),
-                "(link)".style(self.theme.styles.link)
+                display_text.style(self.theme.styles.link)
             );
             write!(header, "{}", link)?;
             writeln!(f, "{}", header)?;
diff --git a/tests/graphical.rs b/tests/graphical.rs
index 32e3441..7e5de78 100644
--- a/tests/graphical.rs
+++ b/tests/graphical.rs
@@ -1341,6 +1341,28 @@ fn disable_url_links() -> Result<(), MietteError> {
     Ok(())
 }
 
+#[test]
+fn url_links_with_display_text() -> Result<(), MietteError> {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("oops!")]
+    #[diagnostic(
+        code(oops::my::bad),
+        help("try doing it better next time?"),
+        url("https://example.com")
+    )]
+    struct MyBad;
+    let err = MyBad;
+    let out = fmt_report_with_settings(err.into(), |handler| {
+        handler.with_link_display_text("Read the documentation")
+    });
+
+    println!("Error: {}", out);
+    assert!(out.contains("https://example.com"));
+    assert!(out.contains("Read the documentation"));
+    assert!(out.contains("oops::my::bad"));
+    Ok(())
+}
+
 #[test]
 fn related() -> Result<(), MietteError> {
     #[derive(Debug, Diagnostic, Error)]

From a4011d174c40acbba5b0176db7cb71ec5ca0cb49 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kat=20March=C3=A1n?= <kzm@zkat.tech>
Date: Sun, 4 Feb 2024 17:25:35 -0800
Subject: [PATCH 48/67] feat(deps): bump dependencies

Fixes: https://github.com/zkat/miette/issues/336

BREAKING CHANGE: This bumps owo-colors to 4.0, which is a breaking change because we expose its styles as part of the graphical renderer API
---
 Cargo.toml               | 20 ++++++++++----------
 miette-derive/Cargo.toml |  4 ++--
 2 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/Cargo.toml b/Cargo.toml
index 450cf2d..f3b809e 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -13,34 +13,34 @@ rust-version = "1.70.0"
 exclude = ["images/", "tests/", "miette-derive/"]
 
 [dependencies]
-thiserror = "1.0.40"
+thiserror = "1.0.56"
 miette-derive = { path = "miette-derive", version = "=6.0.1", optional = true }
-unicode-width = "0.1.9"
+unicode-width = "0.1.11"
 
-owo-colors = { version = "3.4.0", optional = true }
+owo-colors = { version = "4.0.0", optional = true }
 textwrap = { version = "0.16.0", optional = true }
 supports-hyperlinks = { version = "3.0.0", optional = true }
 supports-color = { version = "3.0.0", optional = true }
 supports-unicode = { version = "3.0.0", optional = true }
-backtrace = { version = "0.3.61", optional = true }
+backtrace = { version = "0.3.69", optional = true }
 terminal_size = { version = "0.3.0", optional = true }
 backtrace-ext = { version = "0.2.1", optional = true }
-serde = { version = "1.0.162", features = ["derive"], optional = true }
+serde = { version = "1.0.196", features = ["derive"], optional = true }
 syntect = { version = "5.1.0", optional = true }
 
 [dev-dependencies]
-semver = "1.0.4"
+semver = "1.0.21"
 
 # Eyre devdeps
 futures = { version = "0.3", default-features = false }
-indenter = "0.3.0"
+indenter = "0.3.3"
 rustversion = "1.0"
-trybuild = { version = "1.0.19", features = ["diff"] }
+trybuild = { version = "1.0.89", features = ["diff"] }
 syn = { version = "2.0", features = ["full"] }
-regex = "1.5"
+regex = "1.10"
 lazy_static = "1.4"
 
-serde_json = "1.0.64"
+serde_json = "1.0.113"
 strip-ansi-escapes = "0.2.0"
 
 [features]
diff --git a/miette-derive/Cargo.toml b/miette-derive/Cargo.toml
index 7945edf..d1f2fdd 100644
--- a/miette-derive/Cargo.toml
+++ b/miette-derive/Cargo.toml
@@ -11,6 +11,6 @@ repository = "https://github.com/zkat/miette"
 proc-macro = true
 
 [dependencies]
-proc-macro2 = "1.0.60"
+proc-macro2 = "1.0.78"
 quote = "1.0"
-syn = "2.0.11"
+syn = "2.0.48"

From ea12e3f7812d037219bead5cd5b8f4ee838509d7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kat=20March=C3=A1n?= <kzm@zkat.tech>
Date: Sun, 4 Feb 2024 17:59:06 -0800
Subject: [PATCH 49/67] docs: update changelog

---
 CHANGELOG.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4de742a..893921a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,18 @@
 # `miette` Release Changelog
 
+<a name="7.0.0"></a>
+## 7.0.0 (2024-02-05)
+
+This is a small breaking release on the heels of 6.0 because I neglected to
+bump owo-colors. I figured it's a good time to do it, before 6.0 gets more
+widely used.
+
+### Features
+
+* **fancy:** Add option to change the link display text (#335) ([c7144ee5](https://github.com/zkat/miette/commit/c7144ee513bf8f06c5f7d89c45436802994a51fc))
+* **deps:** bump dependencies ([a4011d17](https://github.com/zkat/miette/commit/a4011d174c40acbba5b0176db7cb71ec5ca0cb49))
+    * **BREAKING CHANGE**: This bumps owo-colors to 4.0, which is a breaking change because we expose its styles as part of the graphical renderer API
+
 <a name="6.0.1"></a>
 ## 6.0.1 (2024-02-04)
 

From ecb01022f09a290fda90d0657d7df653c3499e09 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kat=20March=C3=A1n?= <kzm@zkat.tech>
Date: Sun, 4 Feb 2024 17:59:20 -0800
Subject: [PATCH 50/67] chore: Release

---
 Cargo.toml               | 4 ++--
 miette-derive/Cargo.toml | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/Cargo.toml b/Cargo.toml
index f3b809e..4ffe9b8 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "miette"
-version = "6.0.1"
+version = "7.0.0"
 authors = ["Kat Marchán <kzm@zkat.tech>"]
 description = "Fancy diagnostic reporting library and protocol for us mere mortals who aren't compiler hackers."
 categories = ["rust-patterns"]
@@ -14,7 +14,7 @@ exclude = ["images/", "tests/", "miette-derive/"]
 
 [dependencies]
 thiserror = "1.0.56"
-miette-derive = { path = "miette-derive", version = "=6.0.1", optional = true }
+miette-derive = { path = "miette-derive", version = "=7.0.0", optional = true }
 unicode-width = "0.1.11"
 
 owo-colors = { version = "4.0.0", optional = true }
diff --git a/miette-derive/Cargo.toml b/miette-derive/Cargo.toml
index d1f2fdd..822f754 100644
--- a/miette-derive/Cargo.toml
+++ b/miette-derive/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "miette-derive"
-version = "6.0.1"
+version = "7.0.0"
 authors = ["Kat Marchán <kzm@zkat.tech>"]
 edition = "2018"
 license = "Apache-2.0"

From 6e829f8c0ce2fc7bb2fc4041e6a6072f12db1f71 Mon Sep 17 00:00:00 2001
From: Brooks Rady <b.j.rady@gmail.com>
Date: Wed, 7 Feb 2024 18:17:42 +0000
Subject: [PATCH 51/67] fix(tests): revert test-breaking changes of e5c7ae4
 (#339)

The commit e5c7ae4 seemed to (potentially erronously?) remove a number of
spaces following the left `|` bar of some graphical report handler tests.
That change had no effect on the `syntax_highlighter_on_real_file()`
test, presumably because the trailing whitespace is removed by
`strip_ansi_escapes::strip_str()`, but it did break the
`triple_adjacent_highlight()` and `non_adjacent_hightlight()` tests.
Restoring the spaces removed in e5c7ae4 fixes the failing tests on main.

* fix(ci): move from minimal-versions to direct-minimal-versions
---
 .github/workflows/ci.yml |  2 +-
 Cargo.toml               |  2 +-
 miette-derive/Cargo.toml |  2 +-
 tests/graphical.rs       | 16 ++++++++--------
 4 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index d5f437e..b1eef7d 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -79,4 +79,4 @@ jobs:
         with:
           toolchain: nightly
       - name: Run minimal version build
-        run: cargo build -Z minimal-versions --features fancy,no-format-args-capture
+        run: cargo build -Z direct-minimal-versions --features fancy,no-format-args-capture
diff --git a/Cargo.toml b/Cargo.toml
index 4ffe9b8..0fa1685 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -36,7 +36,7 @@ futures = { version = "0.3", default-features = false }
 indenter = "0.3.3"
 rustversion = "1.0"
 trybuild = { version = "1.0.89", features = ["diff"] }
-syn = { version = "2.0", features = ["full"] }
+syn = { version = "2.0.48", features = ["full"] }
 regex = "1.10"
 lazy_static = "1.4"
 
diff --git a/miette-derive/Cargo.toml b/miette-derive/Cargo.toml
index 822f754..c1e4eb2 100644
--- a/miette-derive/Cargo.toml
+++ b/miette-derive/Cargo.toml
@@ -12,5 +12,5 @@ proc-macro = true
 
 [dependencies]
 proc-macro2 = "1.0.78"
-quote = "1.0"
+quote = "1.0.35"
 syn = "2.0.48"
diff --git a/tests/graphical.rs b/tests/graphical.rs
index 7e5de78..b5fa4d8 100644
--- a/tests/graphical.rs
+++ b/tests/graphical.rs
@@ -1864,11 +1864,11 @@ fn syntax_highlighter_on_real_file() {
     let expected = format!(
         r#"  × This is an error
       ╭─[{filename}:{l2}:{CO}]
- {l1} │
+ {l1} │ 
  {l2} │     let (filename, line) = (file!(), line!() as usize);
       ·                            ─────────────┬─────────────
       ·                                         ╰── this is a label
- {l3} │
+ {l3} │ 
       ╰────
 "#,
         l1 = line - 1,
@@ -1911,13 +1911,13 @@ fn triple_adjacent_highlight() -> Result<(), MietteError> {
  1 │ source
    · ───┬──
    ·    ╰── this bit here
- 2 │
- 3 │
+ 2 │ 
+ 3 │ 
  4 │   text
    ·   ──┬─
    ·     ╰── also this bit
- 5 │
- 6 │
+ 5 │ 
+ 6 │ 
  7 │     here
    ·     ──┬─
    ·       ╰── finally we got
@@ -1957,10 +1957,10 @@ fn non_adjacent_highlight() -> Result<(), MietteError> {
  1 │ source
    · ───┬──
    ·    ╰── this bit here
- 2 │
+ 2 │ 
    ╰────
    ╭─[bad_file.rs:5:3]
- 4 │
+ 4 │ 
  5 │   text    here
    ·   ──┬─
    ·     ╰── also this bit

From c2f06f6cca15cbdd083dbff3d46b7729056ac6a4 Mon Sep 17 00:00:00 2001
From: Brooks Rady <b.j.rady@gmail.com>
Date: Wed, 7 Feb 2024 18:20:18 +0000
Subject: [PATCH 52/67] feat(derive): enable more boxed types to be
 #[diagnostic_source] (#338)

---
 src/protocol.rs                       | 21 +++++++++++++++++++--
 tests/test_diagnostic_source_macro.rs | 14 ++++++++++++++
 2 files changed, 33 insertions(+), 2 deletions(-)

diff --git a/src/protocol.rs b/src/protocol.rs
index 6b98a97..310fc86 100644
--- a/src/protocol.rs
+++ b/src/protocol.rs
@@ -69,7 +69,7 @@ pub trait Diagnostic: std::error::Error {
     }
 }
 
-macro_rules! box_impls {
+macro_rules! box_error_impls {
     ($($box_type:ty),*) => {
         $(
             impl std::error::Error for $box_type {
@@ -85,12 +85,29 @@ macro_rules! box_impls {
     }
 }
 
-box_impls! {
+box_error_impls! {
     Box<dyn Diagnostic>,
     Box<dyn Diagnostic + Send>,
     Box<dyn Diagnostic + Send + Sync>
 }
 
+macro_rules! box_borrow_impls {
+    ($($box_type:ty),*) => {
+        $(
+            impl std::borrow::Borrow<dyn Diagnostic> for $box_type {
+                fn borrow(&self) -> &(dyn Diagnostic + 'static) {
+                    self.as_ref()
+                }
+            }
+        )*
+    }
+}
+
+box_borrow_impls! {
+    Box<dyn Diagnostic + Send>,
+    Box<dyn Diagnostic + Send + Sync>
+}
+
 impl<T: Diagnostic + Send + Sync + 'static> From<T>
     for Box<dyn Diagnostic + Send + Sync + 'static>
 {
diff --git a/tests/test_diagnostic_source_macro.rs b/tests/test_diagnostic_source_macro.rs
index e5305ac..939812c 100644
--- a/tests/test_diagnostic_source_macro.rs
+++ b/tests/test_diagnostic_source_macro.rs
@@ -41,6 +41,14 @@ struct TestTupleError(#[diagnostic_source] AnErr);
 #[error("TestError")]
 struct TestBoxedError(#[diagnostic_source] Box<dyn Diagnostic>);
 
+#[derive(Debug, miette::Diagnostic, thiserror::Error)]
+#[error("TestError")]
+struct TestBoxedSendError(#[diagnostic_source] Box<dyn Diagnostic + Send>);
+
+#[derive(Debug, miette::Diagnostic, thiserror::Error)]
+#[error("TestError")]
+struct TestBoxedSendSyncError(#[diagnostic_source] Box<dyn Diagnostic + Send + Sync>);
+
 #[derive(Debug, miette::Diagnostic, thiserror::Error)]
 #[error("TestError")]
 struct TestArcedError(#[diagnostic_source] std::sync::Arc<dyn Diagnostic>);
@@ -71,6 +79,12 @@ fn test_diagnostic_source() {
     let error = TestBoxedError(Box::new(AnErr));
     assert!(error.diagnostic_source().is_some());
 
+    let error = TestBoxedSendError(Box::new(AnErr));
+    assert!(error.diagnostic_source().is_some());
+
+    let error = TestBoxedSendSyncError(Box::new(AnErr));
+    assert!(error.diagnostic_source().is_some());
+
     let error = TestArcedError(std::sync::Arc::new(AnErr));
     assert!(error.diagnostic_source().is_some());
 }

From 6f09250cca14561f07fba899a8e6d3c0df14230e Mon Sep 17 00:00:00 2001
From: Brooks Rady <b.j.rady@gmail.com>
Date: Thu, 8 Feb 2024 22:16:49 +0000
Subject: [PATCH 53/67] feat(source): derive common traits for NamedSource,
 SourceSpan, and SourceOffset (#340)

---
 src/named_source.rs | 1 +
 src/protocol.rs     | 4 ++--
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/named_source.rs b/src/named_source.rs
index 99e74a8..ea11cd2 100644
--- a/src/named_source.rs
+++ b/src/named_source.rs
@@ -3,6 +3,7 @@ use crate::{MietteError, MietteSpanContents, SourceCode, SpanContents};
 /// Utility struct for when you have a regular [`SourceCode`] type that doesn't
 /// implement `name`. For example [`String`]. Or if you want to override the
 /// `name` returned by the `SourceCode`.
+#[derive(Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
 pub struct NamedSource<S: SourceCode + 'static> {
     source: S,
     name: String,
diff --git a/src/protocol.rs b/src/protocol.rs
index 310fc86..9f312db 100644
--- a/src/protocol.rs
+++ b/src/protocol.rs
@@ -550,7 +550,7 @@ impl<'a> SpanContents<'a> for MietteSpanContents<'a> {
 }
 
 /// Span within a [`SourceCode`]
-#[derive(Clone, Copy, Debug, Eq, PartialEq, Hash)]
+#[derive(Clone, Copy, Debug, Eq, PartialEq, Ord, PartialOrd, Hash)]
 #[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
 pub struct SourceSpan {
     /// The start of the span.
@@ -652,7 +652,7 @@ pub type ByteOffset = usize;
 /**
 Newtype that represents the [`ByteOffset`] from the beginning of a [`SourceCode`]
 */
-#[derive(Clone, Copy, Debug, Eq, PartialEq, Hash)]
+#[derive(Clone, Copy, Debug, Eq, PartialEq, Ord, PartialOrd, Hash)]
 #[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
 pub struct SourceOffset(ByteOffset);
 

From 03060245d816a53a33209e6b7e1c3c42948e9962 Mon Sep 17 00:00:00 2001
From: Nahor <nahor.j+github@gmail.com>
Date: Thu, 15 Feb 2024 18:14:04 -0800
Subject: [PATCH 54/67] feat(collection): add support for collection of labels
 (#341)

Fixes: https://github.com/zkat/miette/issues/315

Allow errors to have a number of labels determined at runtime.
An example of this is when the rust compiler labels all the arms of
a `match` expression when one of them has an incompatible type

To allow customization of the text for each label in a collection, add
support for using LabeledSpan in collections instead of just regular
spans
---
 README.md                       |  52 ++++++
 miette-derive/src/label.rs      | 217 +++++++++++++++-------
 src/macro_helpers.rs            |  23 +++
 src/protocol.rs                 |   5 +
 tests/test_derive_collection.rs | 306 ++++++++++++++++++++++++++++++++
 5 files changed, 537 insertions(+), 66 deletions(-)
 create mode 100644 tests/test_derive_collection.rs

diff --git a/README.md b/README.md
index 0e936b3..302e0b5 100644
--- a/README.md
+++ b/README.md
@@ -49,6 +49,7 @@ libraries and such might not want.
   - [... handler options](#-handler-options)
   - [... dynamic diagnostics](#-dynamic-diagnostics)
   - [... syntax highlighting](#-syntax-highlighting)
+  - [... collection of labels](#-collection-of-labels)
 - [Acknowledgements](#acknowledgements)
 - [License](#license)
 
@@ -671,6 +672,57 @@ trait to [`MietteHandlerOpts`] by calling the
 [`with_syntax_highlighting`](MietteHandlerOpts::with_syntax_highlighting)
 method. See the [`highlighters`] module docs for more details.
 
+#### ... collection of labels
+
+When the number of labels is unknown, you can use a collection of `SourceSpan`
+(or any type convertible into `SourceSpan`). For this, add the `collection`
+parameter to `label` and use any type than can be iterated over for the field.
+
+```rust
+#[derive(Debug, Diagnostic, Error)]
+#[error("oops!")]
+struct MyError {
+    #[label("main issue")]
+    primary_span: SourceSpan,
+
+    #[label(collection, "related to this")]
+    other_spans: Vec<Range<usize>>,
+}
+
+let report: miette::Report = MyError {
+    primary_span: (6, 9).into(),
+    other_spans: vec![19..26, 30..41],
+}.into();
+
+println!("{:?}", report.with_source_code("About something or another or yet another ...".to_string()));
+```
+
+A collection can also be of `LabeledSpan` if you want to have different text
+for different labels. Labels with no text will use the one from the `label`
+attribute
+
+```rust
+#[derive(Debug, Diagnostic, Error)]
+#[error("oops!")]
+struct MyError {
+    #[label("main issue")]
+    primary_span: SourceSpan,
+
+    #[label(collection, "related to this")]
+    other_spans: Vec<LabeledSpan>, // LabeledSpan
+}
+
+let report: miette::Report = MyError {
+    primary_span: (6, 9).into(),
+    other_spans: vec![
+        LabeledSpan::new(None, 19, 7), // Use default text `related to this`
+        LabeledSpan::new(Some("and also this".to_string()), 30, 11), // Use specific text
+    ],
+}.into();
+
+println!("{:?}", report.with_source_code("About something or another or yet another ...".to_string()));
+```
+
 ### MSRV
 
 This crate requires rustc 1.70.0 or later.
diff --git a/miette-derive/src/label.rs b/miette-derive/src/label.rs
index dd5ec69..cd6994a 100644
--- a/miette-derive/src/label.rs
+++ b/miette-derive/src/label.rs
@@ -16,16 +16,23 @@ use crate::{
 
 pub struct Labels(Vec<Label>);
 
+#[derive(PartialEq, Eq)]
+enum LabelType {
+    Default,
+    Primary,
+    Collection,
+}
+
 struct Label {
     label: Option<Display>,
     ty: syn::Type,
     span: syn::Member,
-    primary: bool,
+    lbl_ty: LabelType,
 }
 
 struct LabelAttr {
     label: Option<Display>,
-    primary: bool,
+    lbl_ty: LabelType,
 }
 
 impl Parse for LabelAttr {
@@ -42,20 +49,24 @@ impl Parse for LabelAttr {
             }
         });
         let la = input.lookahead1();
-        let (primary, label) = if la.peek(syn::token::Paren) {
+        let (lbl_ty, label) = if la.peek(syn::token::Paren) {
             // #[label(primary?, "{}", x)]
             let content;
             parenthesized!(content in input);
 
-            let primary = if content.peek(syn::Ident) {
-                let ident: syn::Ident = content.parse()?;
-                if ident != "primary" {
-                    return Err(syn::Error::new(input.span(), "Invalid argument to label() attribute. The argument must be a literal string or the keyword `primary`."));
+            let attr = match content.parse::<Option<syn::Ident>>()? {
+                Some(ident) if ident == "primary" => {
+                    let _ = content.parse::<Token![,]>();
+                    LabelType::Primary
                 }
-                let _ = content.parse::<Token![,]>();
-                true
-            } else {
-                false
+                Some(ident) if ident == "collection" => {
+                    let _ = content.parse::<Token![,]>();
+                    LabelType::Collection
+                }
+                Some(_) => {
+                    return Err(syn::Error::new(input.span(), "Invalid argument to label() attribute. The argument must be a literal string or either the keyword `primary` or `collection`."));
+                }
+                _ => LabelType::Default,
             };
 
             if content.peek(syn::LitStr) {
@@ -70,17 +81,17 @@ impl Parse for LabelAttr {
                     args,
                     has_bonus_display: false,
                 };
-                (primary, Some(display))
-            } else if !primary {
-                return Err(syn::Error::new(input.span(), "Invalid argument to label() attribute. The argument must be a literal string or the keyword `primary`."));
+                (attr, Some(display))
+            } else if !content.is_empty() {
+                return Err(syn::Error::new(input.span(), "Invalid argument to label() attribute. The argument must be a literal string or either the keyword `primary` or `collection`."));
             } else {
-                (primary, None)
+                (attr, None)
             }
         } else if la.peek(Token![=]) {
             // #[label = "blabla"]
             input.parse::<Token![=]>()?;
             (
-                false,
+                LabelType::Default,
                 Some(Display {
                     fmt: input.parse()?,
                     args: TokenStream::new(),
@@ -88,9 +99,9 @@ impl Parse for LabelAttr {
                 }),
             )
         } else {
-            (false, None)
+            (LabelType::Default, None)
         };
-        Ok(LabelAttr { label, primary })
+        Ok(LabelAttr { label, lbl_ty })
     }
 }
 
@@ -119,10 +130,14 @@ impl Labels {
                         })
                     };
                     use quote::ToTokens;
-                    let LabelAttr { label, primary } =
+                    let LabelAttr { label, lbl_ty } =
                         syn::parse2::<LabelAttr>(attr.meta.to_token_stream())?;
 
-                    if primary && labels.iter().any(|l: &Label| l.primary) {
+                    if lbl_ty == LabelType::Primary
+                        && labels
+                            .iter()
+                            .any(|l: &Label| l.lbl_ty == LabelType::Primary)
+                    {
                         return Err(syn::Error::new(
                             field.span(),
                             "Cannot have more than one primary label.",
@@ -133,7 +148,7 @@ impl Labels {
                         label,
                         span,
                         ty: field.ty.clone(),
-                        primary,
+                        lbl_ty,
                     });
                 }
             }
@@ -147,46 +162,82 @@ impl Labels {
 
     pub(crate) fn gen_struct(&self, fields: &syn::Fields) -> Option<TokenStream> {
         let (display_pat, display_members) = display_pat_members(fields);
-        let labels = self.0.iter().map(|highlight| {
+        let labels_gen_var = quote! { labels };
+        let labels = self.0.iter().filter_map(|highlight| {
             let Label {
                 span,
                 label,
                 ty,
-                primary,
+                lbl_ty,
             } = highlight;
+            if *lbl_ty == LabelType::Collection {
+                return None;
+            }
             let var = quote! { __miette_internal_var };
-            let ctor = if *primary {
+            let display = if let Some(display) = label {
+                let (fmt, args) = display.expand_shorthand_cloned(&display_members);
+                quote! { std::option::Option::Some(format!(#fmt #args)) }
+            } else {
+                quote! { std::option::Option::None }
+            };
+            let ctor = if *lbl_ty == LabelType::Primary {
                 quote! { miette::LabeledSpan::new_primary_with_span }
             } else {
                 quote! { miette::LabeledSpan::new_with_span }
             };
-            if let Some(display) = label {
-                let (fmt, args) = display.expand_shorthand_cloned(&display_members);
-                quote! {
-                    miette::macro_helpers::OptionalWrapper::<#ty>::new().to_option(&self.#span)
-                    .map(|#var| #ctor(
-                        std::option::Option::Some(format!(#fmt #args)),
-                        #var.clone(),
-                    ))
-                }
-            } else {
-                quote! {
-                    miette::macro_helpers::OptionalWrapper::<#ty>::new().to_option(&self.#span)
-                    .map(|#var| #ctor(
-                        std::option::Option::None,
-                        #var.clone(),
-                    ))
-                }
-            }
+
+            Some(quote! {
+                miette::macro_helpers::OptionalWrapper::<#ty>::new().to_option(&self.#span)
+                .map(|#var| #ctor(
+                    #display,
+                    #var.clone(),
+                ))
+            })
         });
+        let collections = self.0.iter().filter_map(|label| {
+            let Label {
+                span,
+                label,
+                ty,
+                lbl_ty,
+            } = label;
+            if *lbl_ty != LabelType::Collection {
+                return None;
+            }
+            let display = if let Some(display) = label {
+                let (fmt, args) = display.expand_shorthand_cloned(&display_members);
+                quote! { std::option::Option::Some(format!(#fmt #args)) }
+            } else {
+                quote! { std::option::Option::None }
+            };
+            Some(quote! {
+                let display = #display;
+                #labels_gen_var.extend(self.#span.iter().map(|label| {
+                    miette::macro_helpers::OptionalWrapper::<#ty>::new().to_option(label)
+                        .map(|span| {
+                            use miette::macro_helpers::{ToLabelSpanWrapper,ToLabeledSpan};
+                            let mut labeled_span = ToLabelSpanWrapper::to_labeled_span(span.clone());
+                            if #display.is_some() && labeled_span.label().is_none() {
+                                labeled_span.set_label(#display)
+                            }
+                            labeled_span
+                        })
+                }));
+            })
+        });
+
         Some(quote! {
             #[allow(unused_variables)]
             fn labels(&self) -> std::option::Option<std::boxed::Box<dyn std::iter::Iterator<Item = miette::LabeledSpan> + '_>> {
                 use miette::macro_helpers::ToOption;
                 let Self #display_pat = self;
-                std::option::Option::Some(Box::new(vec![
+
+                let mut #labels_gen_var = vec![
                     #(#labels),*
-                ].into_iter().filter(Option::is_some).map(Option::unwrap)))
+                ];
+                #(#collections)*
+
+                std::option::Option::Some(Box::new(#labels_gen_var.into_iter().filter(Option::is_some).map(Option::unwrap)))
             }
         })
     }
@@ -198,8 +249,12 @@ impl Labels {
             |ident, fields, DiagnosticConcreteArgs { labels, .. }| {
                 let (display_pat, display_members) = display_pat_members(fields);
                 labels.as_ref().and_then(|labels| {
-                    let variant_labels = labels.0.iter().map(|label| {
-                        let Label { span, label, ty, primary } = label;
+                    let labels_gen_var = quote! { labels };
+                    let variant_labels = labels.0.iter().filter_map(|label| {
+                        let Label { span, label, ty, lbl_ty } = label;
+                        if *lbl_ty == LabelType::Collection {
+                            return None;
+                        }
                         let field = match &span {
                             syn::Member::Named(ident) => ident.clone(),
                             syn::Member::Unnamed(syn::Index { index, .. }) => {
@@ -207,29 +262,57 @@ impl Labels {
                             }
                         };
                         let var = quote! { __miette_internal_var };
-                        let ctor = if *primary {
+                        let display = if let Some(display) = label {
+                            let (fmt, args) = display.expand_shorthand_cloned(&display_members);
+                            quote! { std::option::Option::Some(format!(#fmt #args)) }
+                        } else {
+                            quote! { std::option::Option::None }
+                        };
+                        let ctor = if *lbl_ty == LabelType::Primary {
                             quote! { miette::LabeledSpan::new_primary_with_span }
                         } else {
                             quote! { miette::LabeledSpan::new_with_span }
                         };
-                        if let Some(display) = label {
-                            let (fmt, args) = display.expand_shorthand_cloned(&display_members);
-                            quote! {
-                                miette::macro_helpers::OptionalWrapper::<#ty>::new().to_option(#field)
-                                .map(|#var| #ctor(
-                                    std::option::Option::Some(format!(#fmt #args)),
-                                    #var.clone(),
-                                ))
-                            }
-                        } else {
-                            quote! {
-                                miette::macro_helpers::OptionalWrapper::<#ty>::new().to_option(#field)
-                                .map(|#var| #ctor(
-                                    std::option::Option::None,
-                                    #var.clone(),
-                                ))
-                            }
+
+                        Some(quote! {
+                            miette::macro_helpers::OptionalWrapper::<#ty>::new().to_option(#field)
+                            .map(|#var| #ctor(
+                                #display,
+                                #var.clone(),
+                            ))
+                        })
+                    });
+                    let collections = labels.0.iter().filter_map(|label| {
+                        let Label { span, label, ty, lbl_ty } = label;
+                        if *lbl_ty != LabelType::Collection {
+                            return None;
                         }
+                        let field = match &span {
+                            syn::Member::Named(ident) => ident.clone(),
+                            syn::Member::Unnamed(syn::Index { index, .. }) => {
+                                format_ident!("_{}", index)
+                            }
+                        };
+                        let display = if let Some(display) = label {
+                            let (fmt, args) = display.expand_shorthand_cloned(&display_members);
+                            quote! { std::option::Option::Some(format!(#fmt #args)) }
+                        } else {
+                            quote! { std::option::Option::None }
+                        };
+                        Some(quote! {
+                            let display = #display;
+                            #labels_gen_var.extend(#field.iter().map(|label| {
+                                miette::macro_helpers::OptionalWrapper::<#ty>::new().to_option(label)
+                                    .map(|span| {
+                                        use miette::macro_helpers::{ToLabelSpanWrapper,ToLabeledSpan};
+                                        let mut labeled_span = ToLabelSpanWrapper::to_labeled_span(span.clone());
+                                        if #display.is_some() && labeled_span.label().is_none() {
+                                            labeled_span.set_label(#display)
+                                        }
+                                        labeled_span
+                                    })
+                            }));
+                        })
                     });
                     let variant_name = ident.clone();
                     match &fields {
@@ -237,9 +320,11 @@ impl Labels {
                         _ => Some(quote! {
                             Self::#variant_name #display_pat => {
                                 use miette::macro_helpers::ToOption;
-                                std::option::Option::Some(std::boxed::Box::new(vec![
+                                let mut #labels_gen_var = vec![
                                     #(#variant_labels),*
-                                ].into_iter().filter(Option::is_some).map(Option::unwrap)))
+                                ];
+                                #(#collections)*
+                                std::option::Option::Some(std::boxed::Box::new(#labels_gen_var.into_iter().filter(Option::is_some).map(Option::unwrap)))
                             }
                         }),
                     }
diff --git a/src/macro_helpers.rs b/src/macro_helpers.rs
index 5520899..157f2b3 100644
--- a/src/macro_helpers.rs
+++ b/src/macro_helpers.rs
@@ -1,3 +1,5 @@
+use crate::protocol::{LabeledSpan, SourceSpan};
+
 // Huge thanks to @jam1gamer for this hack:
 // https://twitter.com/jam1garner/status/1515887996444323840
 
@@ -36,3 +38,24 @@ impl<T> ToOption for &OptionalWrapper<T> {
         Some(value)
     }
 }
+
+#[doc(hidden)]
+#[derive(Debug)]
+pub struct ToLabelSpanWrapper {}
+pub trait ToLabeledSpan<T> {
+    #[doc(hidden)]
+    fn to_labeled_span(span: T) -> LabeledSpan;
+}
+impl ToLabeledSpan<LabeledSpan> for ToLabelSpanWrapper {
+    fn to_labeled_span(span: LabeledSpan) -> LabeledSpan {
+        span
+    }
+}
+impl<T> ToLabeledSpan<T> for ToLabelSpanWrapper
+where
+    T: Into<SourceSpan>,
+{
+    fn to_labeled_span(span: T) -> LabeledSpan {
+        LabeledSpan::new_with_span(None, span.into())
+    }
+}
diff --git a/src/protocol.rs b/src/protocol.rs
index 9f312db..589cd0b 100644
--- a/src/protocol.rs
+++ b/src/protocol.rs
@@ -293,6 +293,11 @@ impl LabeledSpan {
         }
     }
 
+    /// Change the text of the label
+    pub fn set_label(&mut self, label: Option<String>) {
+        self.label = label;
+    }
+
     /// Makes a new label at specified span
     ///
     /// # Examples
diff --git a/tests/test_derive_collection.rs b/tests/test_derive_collection.rs
new file mode 100644
index 0000000..952b505
--- /dev/null
+++ b/tests/test_derive_collection.rs
@@ -0,0 +1,306 @@
+use std::{
+    collections::{LinkedList, VecDeque},
+    ops::Range,
+};
+
+// Testing of the `diagnostic` attr used by derive(Diagnostic)
+use miette::{Diagnostic, LabeledSpan, NamedSource, SourceSpan};
+use thiserror::Error;
+
+#[test]
+fn attr_collection_in_enum() {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("oops!")]
+    enum MyBad {
+        Only {
+            #[source_code]
+            src: NamedSource<String>,
+            #[label("this bit here")]
+            highlight: SourceSpan,
+            #[label(collection, "and here")]
+            highlight2: Vec<SourceSpan>,
+        },
+    }
+
+    let src = "source\n  text\n    here".to_string();
+    let err = MyBad::Only {
+        src: NamedSource::new("bad_file.rs", src),
+        highlight: (9, 4).into(),
+        highlight2: vec![(1, 2).into(), (3, 4).into()],
+    };
+    let mut label_iter = err.labels().unwrap();
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("this bit here".into()), 9usize, 4usize);
+    assert_eq!(err_span, expectation);
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("and here".into()), 1usize, 2usize);
+    assert_eq!(err_span, expectation);
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("and here".into()), 3usize, 4usize);
+    assert_eq!(err_span, expectation);
+}
+
+#[test]
+fn attr_collection_in_struct() {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("oops!")]
+    struct MyBad {
+        #[source_code]
+        src: NamedSource<String>,
+        #[label("this bit here")]
+        highlight: SourceSpan,
+        #[label(collection, "and here")]
+        highlight2: Vec<SourceSpan>,
+    }
+
+    let src = "source\n  text\n    here".to_string();
+    let err = MyBad {
+        src: NamedSource::new("bad_file.rs", src),
+        highlight: (9, 4).into(),
+        highlight2: vec![(1, 2).into(), (3, 4).into()],
+    };
+    let mut label_iter = err.labels().unwrap();
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("this bit here".into()), 9usize, 4usize);
+    assert_eq!(err_span, expectation);
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("and here".into()), 1usize, 2usize);
+    assert_eq!(err_span, expectation);
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("and here".into()), 3usize, 4usize);
+    assert_eq!(err_span, expectation);
+}
+
+#[test]
+fn attr_collection_as_deque() {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("oops!")]
+    struct MyBad {
+        #[source_code]
+        src: NamedSource<String>,
+        #[label("this bit here")]
+        highlight: SourceSpan,
+        #[label(collection, "and here")]
+        highlight2: VecDeque<SourceSpan>,
+    }
+
+    let src = "source\n  text\n    here".to_string();
+    let err = MyBad {
+        src: NamedSource::new("bad_file.rs", src),
+        highlight: (9, 4).into(),
+        highlight2: VecDeque::from([(1, 2).into(), (3, 4).into()]),
+    };
+    let mut label_iter = err.labels().unwrap();
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("this bit here".into()), 9usize, 4usize);
+    assert_eq!(err_span, expectation);
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("and here".into()), 1usize, 2usize);
+    assert_eq!(err_span, expectation);
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("and here".into()), 3usize, 4usize);
+    assert_eq!(err_span, expectation);
+}
+
+#[test]
+fn attr_collection_as_linked_list() {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("oops!")]
+    struct MyBad {
+        #[source_code]
+        src: NamedSource<String>,
+        #[label("this bit here")]
+        highlight: SourceSpan,
+        #[label(collection, "and here")]
+        highlight2: LinkedList<SourceSpan>,
+    }
+
+    let src = "source\n  text\n    here".to_string();
+    let err = MyBad {
+        src: NamedSource::new("bad_file.rs", src),
+        highlight: (9, 4).into(),
+        highlight2: LinkedList::from([(1, 2).into(), (3, 4).into()]),
+    };
+    let mut label_iter = err.labels().unwrap();
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("this bit here".into()), 9usize, 4usize);
+    assert_eq!(err_span, expectation);
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("and here".into()), 1usize, 2usize);
+    assert_eq!(err_span, expectation);
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("and here".into()), 3usize, 4usize);
+    assert_eq!(err_span, expectation);
+}
+
+#[test]
+fn attr_collection_of_tuple() {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("oops!")]
+    struct MyBad {
+        #[source_code]
+        src: NamedSource<String>,
+        #[label("this bit here")]
+        highlight: SourceSpan,
+        #[label(collection, "and here")]
+        highlight2: Vec<(usize, usize)>,
+    }
+
+    let src = "source\n  text\n    here".to_string();
+    let err = MyBad {
+        src: NamedSource::new("bad_file.rs", src),
+        highlight: (9, 4).into(),
+        highlight2: vec![(1, 2), (3, 4)],
+    };
+    let mut label_iter = err.labels().unwrap();
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("this bit here".into()), 9usize, 4usize);
+    assert_eq!(err_span, expectation);
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("and here".into()), 1usize, 2usize);
+    assert_eq!(err_span, expectation);
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("and here".into()), 3usize, 4usize);
+    assert_eq!(err_span, expectation);
+}
+
+#[test]
+fn attr_collection_of_range() {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("oops!")]
+    struct MyBad {
+        #[source_code]
+        src: NamedSource<String>,
+        #[label("this bit here")]
+        highlight: SourceSpan,
+        #[label(collection, "and here")]
+        highlight2: Vec<Range<usize>>,
+    }
+
+    let src = "source\n  text\n    here".to_string();
+    let err = MyBad {
+        src: NamedSource::new("bad_file.rs", src),
+        highlight: (9, 4).into(),
+        highlight2: vec![1..3, 3..7],
+    };
+    let mut label_iter = err.labels().unwrap();
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("this bit here".into()), 9usize, 4usize);
+    assert_eq!(err_span, expectation);
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("and here".into()), 1usize, 2usize);
+    assert_eq!(err_span, expectation);
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("and here".into()), 3usize, 4usize);
+    assert_eq!(err_span, expectation);
+}
+
+#[test]
+fn attr_collection_of_labeled_span_in_struct() {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("oops!")]
+    struct MyBad {
+        #[source_code]
+        src: NamedSource<String>,
+        #[label("this bit here")]
+        highlight: SourceSpan,
+        #[label(collection, "then there")]
+        highlight2: Vec<LabeledSpan>,
+    }
+
+    let src = "source\n  text\n    here".to_string();
+    let err = MyBad {
+        src: NamedSource::new("bad_file.rs", src),
+        highlight: (9, 4).into(),
+        highlight2: vec![
+            LabeledSpan::new_with_span(Some("continuing here".to_string()), (1, 2)),
+            LabeledSpan::new_with_span(None, (3, 4)),
+        ],
+    };
+    let mut label_iter = err.labels().unwrap();
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("this bit here".into()), 9usize, 4usize);
+    assert_eq!(err_span, expectation);
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("continuing here".into()), 1usize, 2usize);
+    assert_eq!(err_span, expectation);
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("then there".into()), 3usize, 4usize);
+    assert_eq!(err_span, expectation);
+}
+
+#[test]
+fn attr_collection_of_labeled_span_in_enum() {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("oops!")]
+    enum MyBad {
+        Only {
+            #[source_code]
+            src: NamedSource<String>,
+            #[label("this bit here")]
+            highlight: SourceSpan,
+            #[label(collection, "then there")]
+            highlight2: Vec<LabeledSpan>,
+        },
+    }
+
+    let src = "source\n  text\n    here".to_string();
+    let err = MyBad::Only {
+        src: NamedSource::new("bad_file.rs", src),
+        highlight: (9, 4).into(),
+        highlight2: vec![
+            LabeledSpan::new_with_span(Some("continuing here".to_string()), (1, 2)),
+            LabeledSpan::new_with_span(None, (3, 4)),
+        ],
+    };
+    let mut label_iter = err.labels().unwrap();
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("this bit here".into()), 9usize, 4usize);
+    assert_eq!(err_span, expectation);
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("continuing here".into()), 1usize, 2usize);
+    assert_eq!(err_span, expectation);
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("then there".into()), 3usize, 4usize);
+    assert_eq!(err_span, expectation);
+}
+
+#[test]
+fn attr_collection_multi() {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("oops!")]
+    struct MyBad {
+        #[source_code]
+        src: NamedSource<String>,
+        #[label("this bit here")]
+        highlight: SourceSpan,
+        #[label(collection, "and here")]
+        highlight2: Vec<SourceSpan>,
+        #[label(collection, "and there")]
+        highlight3: Vec<SourceSpan>,
+    }
+
+    let src = "source\n  text\n    here".to_string();
+    let err = MyBad {
+        src: NamedSource::new("bad_file.rs", src),
+        highlight: (9, 4).into(),
+        highlight2: vec![(1, 2).into(), (3, 4).into()],
+        highlight3: vec![(5, 6).into(), (7, 8).into()],
+    };
+    let mut label_iter = err.labels().unwrap();
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("this bit here".into()), 9usize, 4usize);
+    assert_eq!(err_span, expectation);
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("and here".into()), 1usize, 2usize);
+    assert_eq!(err_span, expectation);
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("and here".into()), 3usize, 4usize);
+    assert_eq!(err_span, expectation);
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("and there".into()), 5usize, 6usize);
+    assert_eq!(err_span, expectation);
+    let err_span = label_iter.next().unwrap();
+    let expectation = LabeledSpan::new(Some("and there".into()), 7usize, 8usize);
+    assert_eq!(err_span, expectation);
+}

From dc77b0cb5b350c8405f4cbfd78033729d5f3c63c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kat=20March=C3=A1n?= <kzm@zkat.tech>
Date: Thu, 15 Feb 2024 18:18:32 -0800
Subject: [PATCH 55/67] docs: update changelog

---
 CHANGELOG.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 893921a..47d16bd 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,18 @@
 # `miette` Release Changelog
 
+<a name="7.1.0"></a>
+## 7.1.0 (2024-02-16)
+
+### Features
+
+* **derive:** enable more boxed types to be #[diagnostic_source] (#338) ([c2f06f6c](https://github.com/zkat/miette/commit/c2f06f6cca15cbdd083dbff3d46b7729056ac6a4))
+* **source:** derive common traits for NamedSource, SourceSpan, and SourceOffset (#340) ([6f09250c](https://github.com/zkat/miette/commit/6f09250cca14561f07fba899a8e6d3c0df14230e))
+* **collection:** add support for collection of labels (#341) ([03060245](https://github.com/zkat/miette/commit/03060245d816a53a33209e6b7e1c3c42948e9962))
+
+### Bug Fixes
+
+* **tests:** revert test-breaking changes of e5c7ae4 (#339) ([6e829f8c](https://github.com/zkat/miette/commit/6e829f8c0ce2fc7bb2fc4041e6a6072f12db1f71))
+
 <a name="7.0.0"></a>
 ## 7.0.0 (2024-02-05)
 

From a18a6444d92cd1ada40bfd7e39b86f672c8a6924 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kat=20March=C3=A1n?= <kzm@zkat.tech>
Date: Thu, 15 Feb 2024 18:18:45 -0800
Subject: [PATCH 56/67] chore: Release

---
 Cargo.toml               | 4 ++--
 miette-derive/Cargo.toml | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/Cargo.toml b/Cargo.toml
index 0fa1685..92a6be4 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "miette"
-version = "7.0.0"
+version = "7.1.0"
 authors = ["Kat Marchán <kzm@zkat.tech>"]
 description = "Fancy diagnostic reporting library and protocol for us mere mortals who aren't compiler hackers."
 categories = ["rust-patterns"]
@@ -14,7 +14,7 @@ exclude = ["images/", "tests/", "miette-derive/"]
 
 [dependencies]
 thiserror = "1.0.56"
-miette-derive = { path = "miette-derive", version = "=7.0.0", optional = true }
+miette-derive = { path = "miette-derive", version = "=7.1.0", optional = true }
 unicode-width = "0.1.11"
 
 owo-colors = { version = "4.0.0", optional = true }
diff --git a/miette-derive/Cargo.toml b/miette-derive/Cargo.toml
index c1e4eb2..e18f221 100644
--- a/miette-derive/Cargo.toml
+++ b/miette-derive/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "miette-derive"
-version = "7.0.0"
+version = "7.1.0"
 authors = ["Kat Marchán <kzm@zkat.tech>"]
 edition = "2018"
 license = "Apache-2.0"

From 75fea0935e495d0215518c80d32dd820910982e3 Mon Sep 17 00:00:00 2001
From: Nahor <nahor.j+github@gmail.com>
Date: Sat, 17 Feb 2024 13:46:24 -0800
Subject: [PATCH 57/67] fix(label-collections): Label collection fixes and
 cleanup (#343)

* feat(collection): add label(collection) documentation to lib.rs

* feat(collection): remove repeated formatting of label text

Because of a typo, the label text was being formatted multiple times per
label in a collection. With the fix, the text is formatted only once per
collection

* feat(collection): chain iterators rather than extend vector

Since we are going to iterate anyway, instead of growing the label vector,
chain the iterators. This should be more efficient.

In some cases, this also remove a compilation warning about the label
vector being unnecessarily mutable.

* feat(collection): remove unnecessary `OptionalWrapper`

- In a label collection, there is no need for a `None` label. One should
  just not add that label
- Code wise it is also incorrect. The wrapper will be for a vector of
  spans, not for individual spans. It happens to work anyway, but this was
  not the intended use.
---
 miette-derive/src/label.rs | 74 +++++++++++++++++++-------------------
 src/lib.rs                 | 52 +++++++++++++++++++++++++++
 2 files changed, 88 insertions(+), 38 deletions(-)

diff --git a/miette-derive/src/label.rs b/miette-derive/src/label.rs
index cd6994a..ab2ceac 100644
--- a/miette-derive/src/label.rs
+++ b/miette-derive/src/label.rs
@@ -162,7 +162,6 @@ impl Labels {
 
     pub(crate) fn gen_struct(&self, fields: &syn::Fields) -> Option<TokenStream> {
         let (display_pat, display_members) = display_pat_members(fields);
-        let labels_gen_var = quote! { labels };
         let labels = self.0.iter().filter_map(|highlight| {
             let Label {
                 span,
@@ -194,11 +193,11 @@ impl Labels {
                 ))
             })
         });
-        let collections = self.0.iter().filter_map(|label| {
+        let collections_chain = self.0.iter().filter_map(|label| {
             let Label {
                 span,
                 label,
-                ty,
+                ty: _,
                 lbl_ty,
             } = label;
             if *lbl_ty != LabelType::Collection {
@@ -211,18 +210,17 @@ impl Labels {
                 quote! { std::option::Option::None }
             };
             Some(quote! {
-                let display = #display;
-                #labels_gen_var.extend(self.#span.iter().map(|label| {
-                    miette::macro_helpers::OptionalWrapper::<#ty>::new().to_option(label)
-                        .map(|span| {
-                            use miette::macro_helpers::{ToLabelSpanWrapper,ToLabeledSpan};
-                            let mut labeled_span = ToLabelSpanWrapper::to_labeled_span(span.clone());
-                            if #display.is_some() && labeled_span.label().is_none() {
-                                labeled_span.set_label(#display)
-                            }
-                            labeled_span
-                        })
-                }));
+                .chain({
+                    let display = #display;
+                    self.#span.iter().map(move |span| {
+                        use miette::macro_helpers::{ToLabelSpanWrapper,ToLabeledSpan};
+                        let mut labeled_span = ToLabelSpanWrapper::to_labeled_span(span.clone());
+                        if display.is_some() && labeled_span.label().is_none() {
+                            labeled_span.set_label(display.clone())
+                        }
+                        Some(labeled_span)
+                    })
+                })
             })
         });
 
@@ -232,12 +230,13 @@ impl Labels {
                 use miette::macro_helpers::ToOption;
                 let Self #display_pat = self;
 
-                let mut #labels_gen_var = vec![
+                let labels_iter = vec![
                     #(#labels),*
-                ];
-                #(#collections)*
+                ]
+                .into_iter()
+                #(#collections_chain)*;
 
-                std::option::Option::Some(Box::new(#labels_gen_var.into_iter().filter(Option::is_some).map(Option::unwrap)))
+                std::option::Option::Some(Box::new(labels_iter.filter(Option::is_some).map(Option::unwrap)))
             }
         })
     }
@@ -249,7 +248,6 @@ impl Labels {
             |ident, fields, DiagnosticConcreteArgs { labels, .. }| {
                 let (display_pat, display_members) = display_pat_members(fields);
                 labels.as_ref().and_then(|labels| {
-                    let labels_gen_var = quote! { labels };
                     let variant_labels = labels.0.iter().filter_map(|label| {
                         let Label { span, label, ty, lbl_ty } = label;
                         if *lbl_ty == LabelType::Collection {
@@ -282,8 +280,8 @@ impl Labels {
                             ))
                         })
                     });
-                    let collections = labels.0.iter().filter_map(|label| {
-                        let Label { span, label, ty, lbl_ty } = label;
+                    let collections_chain = labels.0.iter().filter_map(|label| {
+                        let Label { span, label, ty: _, lbl_ty } = label;
                         if *lbl_ty != LabelType::Collection {
                             return None;
                         }
@@ -300,18 +298,17 @@ impl Labels {
                             quote! { std::option::Option::None }
                         };
                         Some(quote! {
-                            let display = #display;
-                            #labels_gen_var.extend(#field.iter().map(|label| {
-                                miette::macro_helpers::OptionalWrapper::<#ty>::new().to_option(label)
-                                    .map(|span| {
-                                        use miette::macro_helpers::{ToLabelSpanWrapper,ToLabeledSpan};
-                                        let mut labeled_span = ToLabelSpanWrapper::to_labeled_span(span.clone());
-                                        if #display.is_some() && labeled_span.label().is_none() {
-                                            labeled_span.set_label(#display)
-                                        }
-                                        labeled_span
-                                    })
-                            }));
+                            .chain({
+                                let display = #display;
+                                #field.iter().map(move |span| {
+                                    use miette::macro_helpers::{ToLabelSpanWrapper,ToLabeledSpan};
+                                    let mut labeled_span = ToLabelSpanWrapper::to_labeled_span(span.clone());
+                                    if display.is_some() && labeled_span.label().is_none() {
+                                        labeled_span.set_label(display.clone());
+                                    }
+                                    Some(labeled_span)
+                                })
+                            })
                         })
                     });
                     let variant_name = ident.clone();
@@ -320,11 +317,12 @@ impl Labels {
                         _ => Some(quote! {
                             Self::#variant_name #display_pat => {
                                 use miette::macro_helpers::ToOption;
-                                let mut #labels_gen_var = vec![
+                                let labels_iter = vec![
                                     #(#variant_labels),*
-                                ];
-                                #(#collections)*
-                                std::option::Option::Some(std::boxed::Box::new(#labels_gen_var.into_iter().filter(Option::is_some).map(Option::unwrap)))
+                                ]
+                                .into_iter()
+                                #(#collections_chain)*;
+                                std::option::Option::Some(std::boxed::Box::new(labels_iter.filter(Option::is_some).map(Option::unwrap)))
                             }
                         }),
                     }
diff --git a/src/lib.rs b/src/lib.rs
index 7674f2b..7891511 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -48,6 +48,7 @@
 //!   - [... handler options](#-handler-options)
 //!   - [... dynamic diagnostics](#-dynamic-diagnostics)
 //!   - [... syntax highlighting](#-syntax-highlighting)
+//!   - [... collection of labels](#-collection-of-labels)
 //! - [Acknowledgements](#acknowledgements)
 //! - [License](#license)
 //!
@@ -672,6 +673,57 @@
 //! [`with_syntax_highlighting`](MietteHandlerOpts::with_syntax_highlighting)
 //! method. See the [`highlighters`] module docs for more details.
 //!
+//! ### ... collection of labels
+//!
+//! When the number of labels is unknown, you can use a collection of `SourceSpan`
+//! (or any type convertible into `SourceSpan`). For this, add the `collection`
+//! parameter to `label` and use any type than can be iterated over for the field.
+//!
+//! ```rust,ignore
+//! #[derive(Debug, Diagnostic, Error)]
+//! #[error("oops!")]
+//! struct MyError {
+//!     #[label("main issue")]
+//!     primary_span: SourceSpan,
+//!
+//!     #[label(collection, "related to this")]
+//!     other_spans: Vec<Range<usize>>,
+//! }
+//!
+//! let report: miette::Report = MyError {
+//!     primary_span: (6, 9).into(),
+//!     other_spans: vec![19..26, 30..41],
+//! }.into();
+//!
+//! println!("{:?}", report.with_source_code("About something or another or yet another ...".to_string()));
+//! ```
+//!
+//! A collection can also be of `LabeledSpan` if you want to have different text
+//! for different labels. Labels with no text will use the one from the `label`
+//! attribute
+//!
+//! ```rust,ignore
+//! #[derive(Debug, Diagnostic, Error)]
+//! #[error("oops!")]
+//! struct MyError {
+//!     #[label("main issue")]
+//!     primary_span: SourceSpan,
+//!
+//!     #[label(collection, "related to this")]
+//!     other_spans: Vec<LabeledSpan>, // LabeledSpan
+//! }
+//!
+//! let report: miette::Report = MyError {
+//!     primary_span: (6, 9).into(),
+//!     other_spans: vec![
+//!         LabeledSpan::new(None, 19, 7), // Use default text `related to this`
+//!         LabeledSpan::new(Some("and also this".to_string()), 30, 11), // Use specific text
+//!     ],
+//! }.into();
+//!
+//! println!("{:?}", report.with_source_code("About something or another or yet another ...".to_string()));
+//! ```
+//!
 //! ## MSRV
 //!
 //! This crate requires rustc 1.70.0 or later.

From 7d9dfc6e8e591f9606c3da55bd8465962358b20f Mon Sep 17 00:00:00 2001
From: Nahor <nahor.j+github@gmail.com>
Date: Wed, 21 Feb 2024 13:46:58 -0800
Subject: [PATCH 58/67] fix(invalid span): skip the snippet when read_span
 fails (#347)

Fixes: https://github.com/zkat/miette/issues/219

When a snippet couldn't be read (typically because the span didn't fit
within the source code), it and the rest of the diagnostic were silently
dropped, which was confusing to the developer.
Now, in place of the snippet, print an error message with the name of
the failed label and the error it triggered, then proceed with the rest
of the diagnostic (footer, related, ...)
---
 src/handlers/graphical.rs |  22 +++-
 tests/graphical.rs        | 226 ++++++++++++++++++++++++++++++++++++++
 2 files changed, 245 insertions(+), 3 deletions(-)

diff --git a/src/handlers/graphical.rs b/src/handlers/graphical.rs
index 3f74227..a4474f9 100644
--- a/src/handlers/graphical.rs
+++ b/src/handlers/graphical.rs
@@ -436,9 +436,25 @@ impl GraphicalReportHandler {
 
         let mut contexts = Vec::with_capacity(labels.len());
         for right in labels.iter().cloned() {
-            let right_conts = source
-                .read_span(right.inner(), self.context_lines, self.context_lines)
-                .map_err(|_| fmt::Error)?;
+            let right_conts =
+                match source.read_span(right.inner(), self.context_lines, self.context_lines) {
+                    Ok(cont) => cont,
+                    Err(err) => {
+                        writeln!(
+                            f,
+                            "  [{} `{}` (offset: {}, length: {}): {:?}]",
+                            "Failed to read contents for label".style(self.theme.styles.error),
+                            right
+                                .label()
+                                .unwrap_or("<none>")
+                                .style(self.theme.styles.link),
+                            right.offset().style(self.theme.styles.link),
+                            right.len().style(self.theme.styles.link),
+                            err.style(self.theme.styles.warning)
+                        )?;
+                        return Ok(());
+                    }
+                };
 
             if contexts.is_empty() {
                 contexts.push((right, right_conts));
diff --git a/tests/graphical.rs b/tests/graphical.rs
index b5fa4d8..4763117 100644
--- a/tests/graphical.rs
+++ b/tests/graphical.rs
@@ -1970,3 +1970,229 @@ fn non_adjacent_highlight() -> Result<(), MietteError> {
     assert_eq!(expected, &out);
     Ok(())
 }
+
+#[test]
+fn invalid_span_bad_offset() -> Result<(), MietteError> {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("oops!")]
+    #[diagnostic(code(oops::my::bad), help("help info"))]
+    struct MyBad {
+        #[source_code]
+        src: NamedSource<String>,
+        #[label = "1st"]
+        highlight1: SourceSpan,
+    }
+
+    let src = "blabla blibli".to_string();
+    let err = MyBad {
+        src: NamedSource::new("bad_file.rs", src),
+        highlight1: (50, 6).into(),
+    };
+    let out = fmt_report(err.into());
+    println!("Error: {}", out);
+    let expected = "oops::my::bad
+
+  × oops!
+  [Failed to read contents for label `1st` (offset: 50, length: 6): OutOfBounds]
+  help: help info
+";
+    assert_eq!(expected, &out);
+    Ok(())
+}
+
+#[test]
+fn invalid_span_bad_length() -> Result<(), MietteError> {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("oops!")]
+    #[diagnostic(code(oops::my::bad), help("help info"))]
+    struct MyBad {
+        #[source_code]
+        src: NamedSource<String>,
+        #[label = "1st"]
+        highlight1: SourceSpan,
+    }
+
+    let src = "blabla blibli".to_string();
+    let err = MyBad {
+        src: NamedSource::new("bad_file.rs", src),
+        highlight1: (0, 50).into(),
+    };
+    let out = fmt_report(err.into());
+    println!("Error: {}", out);
+    let expected = "oops::my::bad
+
+  × oops!
+  [Failed to read contents for label `1st` (offset: 0, length: 50): OutOfBounds]
+  help: help info
+";
+    assert_eq!(expected, &out);
+    Ok(())
+}
+
+#[test]
+fn invalid_span_no_label() -> Result<(), MietteError> {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("oops!")]
+    #[diagnostic(code(oops::my::bad), help("help info"))]
+    struct MyBad {
+        #[source_code]
+        src: NamedSource<String>,
+        #[label]
+        highlight1: SourceSpan,
+    }
+
+    let src = "blabla blibli".to_string();
+    let err = MyBad {
+        src: NamedSource::new("bad_file.rs", src),
+        highlight1: (50, 6).into(),
+    };
+    let out = fmt_report(err.into());
+    println!("Error: {}", out);
+    let expected = "oops::my::bad
+
+  × oops!
+  [Failed to read contents for label `<none>` (offset: 50, length: 6): OutOfBounds]
+  help: help info
+";
+    assert_eq!(expected, &out);
+    Ok(())
+}
+
+#[test]
+fn invalid_span_2nd_label() -> Result<(), MietteError> {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("oops!")]
+    #[diagnostic(code(oops::my::bad), help("help info"))]
+    struct MyBad {
+        #[source_code]
+        src: NamedSource<String>,
+        #[label("1st")]
+        highlight1: SourceSpan,
+        #[label("2nd")]
+        highlight2: SourceSpan,
+    }
+
+    let src = "blabla blibli".to_string();
+    let err = MyBad {
+        src: NamedSource::new("bad_file.rs", src),
+        highlight1: (0, 6).into(),
+        highlight2: (50, 6).into(),
+    };
+    let out = fmt_report(err.into());
+    println!("Error: {}", out);
+    let expected = "oops::my::bad
+
+  × oops!
+  [Failed to read contents for label `2nd` (offset: 50, length: 6): OutOfBounds]
+  help: help info
+";
+    assert_eq!(expected, &out);
+    Ok(())
+}
+
+#[test]
+fn invalid_span_inner() -> Result<(), MietteError> {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("oops inside!")]
+    #[diagnostic(code(oops::my::inner), help("help info"))]
+    struct MyInner {
+        #[source_code]
+        src: NamedSource<String>,
+        #[label("inner label")]
+        inner_label: SourceSpan,
+    }
+
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("oops outside!")]
+    #[diagnostic(code(oops::my::outer), help("help info"))]
+    struct MyBad {
+        #[source_code]
+        src: NamedSource<String>,
+        #[label("outer label")]
+        outer_label: SourceSpan,
+        #[source]
+        inner: MyInner,
+    }
+
+    let src_outer = "outer source".to_string();
+    let src_inner = "inner source".to_string();
+    let err = MyBad {
+        src: NamedSource::new("bad_file.rs", src_outer),
+        outer_label: (0, 6).into(),
+        inner: MyInner {
+            src: NamedSource::new("bad_file2.rs", src_inner),
+            inner_label: (60, 6).into(),
+        },
+    };
+    let out = fmt_report(err.into());
+    println!("Error: {}", out);
+    let expected = "oops::my::outer
+
+  × oops outside!
+  ╰─▶ oops inside!
+   ╭─[bad_file.rs:1:1]
+ 1 │ outer source
+   · ───┬──
+   ·    ╰── outer label
+   ╰────
+  help: help info
+";
+    assert_eq!(expected, &out);
+    Ok(())
+}
+
+#[test]
+fn invalid_span_related() -> Result<(), MietteError> {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("oops inside!")]
+    #[diagnostic(code(oops::my::inner), help("help info"))]
+    struct MyRelated {
+        #[source_code]
+        src: NamedSource<String>,
+        #[label("inner label")]
+        inner_label: SourceSpan,
+    }
+
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("oops outside!")]
+    #[diagnostic(code(oops::my::outer), help("help info"))]
+    struct MyBad {
+        #[source_code]
+        src: NamedSource<String>,
+        #[label("outer label")]
+        outer_label: SourceSpan,
+        #[related]
+        inner: Vec<MyRelated>,
+    }
+
+    let src_outer = "outer source".to_string();
+    let src_inner = "related source".to_string();
+    let err = MyBad {
+        src: NamedSource::new("bad_file.rs", src_outer),
+        outer_label: (0, 6).into(),
+        inner: vec![MyRelated {
+            src: NamedSource::new("bad_file2.rs", src_inner),
+            inner_label: (60, 6).into(),
+        }],
+    };
+    let out = fmt_report(err.into());
+    println!("Error: {}", out);
+    let expected = "oops::my::outer
+
+  × oops outside!
+   ╭─[bad_file.rs:1:1]
+ 1 │ outer source
+   · ───┬──
+   ·    ╰── outer label
+   ╰────
+  help: help info
+
+Error: oops::my::inner
+
+  × oops inside!
+  [Failed to read contents for label `inner label` (offset: 60, length: 6): OutOfBounds]
+  help: help info
+";
+    assert_eq!(expected, &out);
+    Ok(())
+}

From 6ea86a2248854acf88df345814b6c97d31b8b4d9 Mon Sep 17 00:00:00 2001
From: Nahor <nahor.j+github@gmail.com>
Date: Wed, 21 Feb 2024 14:05:17 -0800
Subject: [PATCH 59/67] fix(redundant-import): fix a warning and CI failure in
 nightly (#348)

---
 src/source_impls.rs | 7 +------
 tests/test_repr.rs  | 1 -
 2 files changed, 1 insertion(+), 7 deletions(-)

diff --git a/src/source_impls.rs b/src/source_impls.rs
index e43a665..e362b4a 100644
--- a/src/source_impls.rs
+++ b/src/source_impls.rs
@@ -1,12 +1,7 @@
 /*!
 Default trait implementations for [`SourceCode`].
 */
-use std::{
-    borrow::{Cow, ToOwned},
-    collections::VecDeque,
-    fmt::Debug,
-    sync::Arc,
-};
+use std::{borrow::Cow, collections::VecDeque, fmt::Debug, sync::Arc};
 
 use crate::{MietteError, MietteSpanContents, SourceCode, SourceSpan, SpanContents};
 
diff --git a/tests/test_repr.rs b/tests/test_repr.rs
index 4978fe5..65ea6d5 100644
--- a/tests/test_repr.rs
+++ b/tests/test_repr.rs
@@ -2,7 +2,6 @@ mod drop;
 
 use self::drop::{DetectDrop, Flag};
 use miette::Report;
-use std::marker::Unpin;
 use std::mem;
 
 #[test]

From 328bf3792213fc0bed94e72a39acb722b65141dd Mon Sep 17 00:00:00 2001
From: Boshen <boshenc@gmail.com>
Date: Fri, 23 Feb 2024 23:42:39 +0800
Subject: [PATCH 60/67] feat(wasm): add feature "fancy-no-syscall" for wasm
 targets (#349)

Fixes: https://github.com/zkat/miette/issues/346
---
 .github/workflows/ci.yml | 13 ++++++
 Cargo.toml               |  9 +++-
 src/eyreish/mod.rs       |  8 ++--
 src/handler.rs           | 91 +++++++++++++++++++++++++++++-----------
 src/handlers/mod.rs      |  8 ++--
 src/lib.rs               |  6 +--
 6 files changed, 99 insertions(+), 36 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index b1eef7d..7ab9326 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -49,6 +49,19 @@ jobs:
         if: matrix.rust == '1.70.0'
         run: cargo test --all --verbose --features ${{matrix.features}} no-format-args-capture
 
+  wasm:
+    name: Check Wasm build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@master
+        with:
+          toolchain: stable
+          targets: wasm32-unknown-unknown
+      - name: Check wasm target
+        run: cargo check --target wasm32-unknown-unknown --features fancy-no-syscall
+
   miri:
     name: Miri
     runs-on: ubuntu-latest
diff --git a/Cargo.toml b/Cargo.toml
index 92a6be4..3fefb43 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -16,6 +16,7 @@ exclude = ["images/", "tests/", "miette-derive/"]
 thiserror = "1.0.56"
 miette-derive = { path = "miette-derive", version = "=7.1.0", optional = true }
 unicode-width = "0.1.11"
+cfg-if = "1.0.0"
 
 owo-colors = { version = "4.0.0", optional = true }
 textwrap = { version = "0.16.0", optional = true }
@@ -47,9 +48,15 @@ strip-ansi-escapes = "0.2.0"
 default = ["derive"]
 derive = ["miette-derive"]
 no-format-args-capture = []
-fancy-no-backtrace = [
+fancy-base = [
     "owo-colors",
     "textwrap",
+]
+fancy-no-syscall = [
+    "fancy-base",
+]
+fancy-no-backtrace = [
+    "fancy-base",
     "terminal_size",
     "supports-hyperlinks",
     "supports-color",
diff --git a/src/eyreish/mod.rs b/src/eyreish/mod.rs
index 0dfd878..544c240 100644
--- a/src/eyreish/mod.rs
+++ b/src/eyreish/mod.rs
@@ -24,10 +24,10 @@ pub use ReportHandler as EyreContext;
 #[allow(unreachable_pub)]
 pub use WrapErr as Context;
 
-#[cfg(not(feature = "fancy-no-backtrace"))]
+#[cfg(not(feature = "fancy-base"))]
 use crate::DebugReportHandler;
 use crate::Diagnostic;
-#[cfg(feature = "fancy-no-backtrace")]
+#[cfg(feature = "fancy-base")]
 use crate::MietteHandler;
 
 use error::ErrorImpl;
@@ -102,9 +102,9 @@ fn capture_handler(error: &(dyn Diagnostic + 'static)) -> Box<dyn ReportHandler>
 }
 
 fn get_default_printer(_err: &(dyn Diagnostic + 'static)) -> Box<dyn ReportHandler + 'static> {
-    #[cfg(feature = "fancy-no-backtrace")]
+    #[cfg(feature = "fancy-base")]
     return Box::new(MietteHandler::new());
-    #[cfg(not(feature = "fancy-no-backtrace"))]
+    #[cfg(not(feature = "fancy-base"))]
     return Box::new(DebugReportHandler::new());
 }
 
diff --git a/src/handler.rs b/src/handler.rs
index dcf8b13..95382c0 100644
--- a/src/handler.rs
+++ b/src/handler.rs
@@ -265,17 +265,15 @@ impl MietteHandlerOpts {
             let characters = match self.unicode {
                 Some(true) => ThemeCharacters::unicode(),
                 Some(false) => ThemeCharacters::ascii(),
-                None if supports_unicode::on(supports_unicode::Stream::Stderr) => {
-                    ThemeCharacters::unicode()
-                }
+                None if syscall::supports_unicode() => ThemeCharacters::unicode(),
                 None => ThemeCharacters::ascii(),
             };
             let styles = if self.color == Some(false) {
                 ThemeStyles::none()
-            } else if let Some(color) = supports_color::on(supports_color::Stream::Stderr) {
+            } else if let Some(color_has_16m) = syscall::supports_color_has_16m() {
                 match self.rgb_colors {
                     RgbColors::Always => ThemeStyles::rgb(),
-                    RgbColors::Preferred if color.has_16m => ThemeStyles::rgb(),
+                    RgbColors::Preferred if color_has_16m => ThemeStyles::rgb(),
                     _ => ThemeStyles::ansi(),
                 }
             } else if self.color == Some(true) {
@@ -291,9 +289,7 @@ impl MietteHandlerOpts {
             #[cfg(feature = "syntect-highlighter")]
             let highlighter = if self.color == Some(false) {
                 MietteHighlighter::nocolor()
-            } else if self.color == Some(true)
-                || supports_color::on(supports_color::Stream::Stderr).is_some()
-            {
+            } else if self.color == Some(true) || syscall::supports_color() {
                 match self.highlighter {
                     Some(highlighter) => highlighter,
                     None => match self.rgb_colors {
@@ -366,26 +362,13 @@ impl MietteHandlerOpts {
         if let Some(linkify) = self.linkify {
             linkify
         } else {
-            supports_hyperlinks::on(supports_hyperlinks::Stream::Stderr)
+            syscall::supports_hyperlinks()
         }
     }
 
-    #[cfg(not(miri))]
     pub(crate) fn get_width(&self) -> usize {
-        self.width.unwrap_or_else(|| {
-            terminal_size::terminal_size()
-                .unwrap_or((terminal_size::Width(80), terminal_size::Height(0)))
-                .0
-                 .0 as usize
-        })
-    }
-
-    #[cfg(miri)]
-    // miri doesn't support a syscall (specifically ioctl)
-    // performed by terminal_size, which causes test execution to fail
-    // so when miri is running we'll just fallback to a constant
-    pub(crate) fn get_width(&self) -> usize {
-        self.width.unwrap_or(80)
+        self.width
+            .unwrap_or_else(|| syscall::terminal_width().unwrap_or(80))
     }
 }
 
@@ -430,3 +413,63 @@ impl ReportHandler for MietteHandler {
         self.inner.debug(diagnostic, f)
     }
 }
+
+mod syscall {
+    use cfg_if::cfg_if;
+
+    #[inline]
+    pub(super) fn terminal_width() -> Option<usize> {
+        cfg_if! {
+            if #[cfg(any(feature = "fancy-no-syscall", miri))] {
+                None
+            } else {
+                terminal_size::terminal_size().map(|size| size.0 .0 as usize)
+            }
+        }
+    }
+
+    #[inline]
+    pub(super) fn supports_hyperlinks() -> bool {
+        cfg_if! {
+            if #[cfg(feature = "fancy-no-syscall")] {
+                false
+            } else {
+                supports_hyperlinks::on(supports_hyperlinks::Stream::Stderr)
+            }
+        }
+    }
+
+    #[cfg(feature = "syntect-highlighter")]
+    #[inline]
+    pub(super) fn supports_color() -> bool {
+        cfg_if! {
+            if #[cfg(feature = "fancy-no-syscall")] {
+                false
+            } else {
+                supports_color::on(supports_color::Stream::Stderr).is_some()
+            }
+        }
+    }
+
+    #[inline]
+    pub(super) fn supports_color_has_16m() -> Option<bool> {
+        cfg_if! {
+            if #[cfg(feature = "fancy-no-syscall")] {
+                None
+            } else {
+                supports_color::on(supports_color::Stream::Stderr).map(|color| color.has_16m)
+            }
+        }
+    }
+
+    #[inline]
+    pub(super) fn supports_unicode() -> bool {
+        cfg_if! {
+            if #[cfg(feature = "fancy-no-syscall")] {
+                false
+            } else {
+                supports_unicode::on(supports_unicode::Stream::Stderr)
+            }
+        }
+    }
+}
diff --git a/src/handlers/mod.rs b/src/handlers/mod.rs
index fde2dc9..ecc7b15 100644
--- a/src/handlers/mod.rs
+++ b/src/handlers/mod.rs
@@ -5,20 +5,20 @@ Reporters included with `miette`.
 #[allow(unreachable_pub)]
 pub use debug::*;
 #[allow(unreachable_pub)]
-#[cfg(feature = "fancy-no-backtrace")]
+#[cfg(feature = "fancy-base")]
 pub use graphical::*;
 #[allow(unreachable_pub)]
 pub use json::*;
 #[allow(unreachable_pub)]
 pub use narratable::*;
 #[allow(unreachable_pub)]
-#[cfg(feature = "fancy-no-backtrace")]
+#[cfg(feature = "fancy-base")]
 pub use theme::*;
 
 mod debug;
-#[cfg(feature = "fancy-no-backtrace")]
+#[cfg(feature = "fancy-base")]
 mod graphical;
 mod json;
 mod narratable;
-#[cfg(feature = "fancy-no-backtrace")]
+#[cfg(feature = "fancy-base")]
 mod theme;
diff --git a/src/lib.rs b/src/lib.rs
index 7891511..90d4653 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -760,7 +760,7 @@ pub use miette_derive::*;
 
 pub use error::*;
 pub use eyreish::*;
-#[cfg(feature = "fancy-no-backtrace")]
+#[cfg(feature = "fancy-base")]
 pub use handler::*;
 pub use handlers::*;
 pub use miette_diagnostic::*;
@@ -773,10 +773,10 @@ mod chain;
 mod diagnostic_chain;
 mod error;
 mod eyreish;
-#[cfg(feature = "fancy-no-backtrace")]
+#[cfg(feature = "fancy-base")]
 mod handler;
 mod handlers;
-#[cfg(feature = "fancy-no-backtrace")]
+#[cfg(feature = "fancy-base")]
 pub mod highlighters;
 #[doc(hidden)]
 pub mod macro_helpers;

From 62cfd221ba0f956825886726166095cec6dbd89c Mon Sep 17 00:00:00 2001
From: Yiyu Lin <linyiyu1992@gmail.com>
Date: Fri, 23 Feb 2024 23:43:22 +0800
Subject: [PATCH 61/67] docs: add `severity` example (#350)

Co-authored-by: hzlinyiyu <hzlinyiyu@corp.netease.com>
---
 README.md | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 302e0b5..7e6ff29 100644
--- a/README.md
+++ b/README.md
@@ -425,7 +425,7 @@ pub struct MyErrorType {
 }
 ```
 
-##### ... help text
+#### ... help text
 `miette` provides two facilities for supplying help text for your errors:
 
 The first is the `#[help()]` format attribute that applies to structs or
@@ -461,6 +461,19 @@ let err = Foo {
 };
 ```
 
+#### ... severity level
+`miette` provides a way to set the severity level of a diagnostic.
+
+```rust
+use miette::Diagnostic;
+use thiserror::Error;
+
+#[derive(Debug, Diagnostic, Error)]
+#[error("welp")]
+#[diagnostic(severity(Warning))]
+struct Foo;
+```
+
 #### ... multiple related errors
 
 `miette` supports collecting multiple errors into a single diagnostic, and
@@ -635,7 +648,7 @@ then you may want to use [`miette!`], [`diagnostic!`] macros or
 
 let source = "2 + 2 * 2 = 8".to_string();
 let report = miette!(
-  labels = vec[
+  labels = vec![
       LabeledSpan::at(12..13, "this should be 6"),
   ],
   help = "'*' has greater precedence than '+'",

From 22b29eec387d9f96dcbf165ab1b34011868315a9 Mon Sep 17 00:00:00 2001
From: Yiyu Lin <linyiyu1992@gmail.com>
Date: Wed, 28 Feb 2024 13:58:02 +0800
Subject: [PATCH 62/67] docs: use `cargo readme` to update (#351)

---
 README.md  |  2 ++
 src/lib.rs | 19 +++++++++++++++++--
 2 files changed, 19 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 7e6ff29..fe69ce2 100644
--- a/README.md
+++ b/README.md
@@ -44,6 +44,8 @@ libraries and such might not want.
   - [... in `main()`](#-in-main)
   - [... diagnostic code URLs](#-diagnostic-code-urls)
   - [... snippets](#-snippets)
+  - [... help text](#-help-text)
+  - [... severity level](#-severity-level)
   - [... multiple related errors](#-multiple-related-errors)
   - [... delayed source code](#-delayed-source-code)
   - [... handler options](#-handler-options)
diff --git a/src/lib.rs b/src/lib.rs
index 90d4653..eee1b9a 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -43,6 +43,8 @@
 //!   - [... in `main()`](#-in-main)
 //!   - [... diagnostic code URLs](#-diagnostic-code-urls)
 //!   - [... snippets](#-snippets)
+//!   - [... help text](#-help-text)
+//!   - [... severity level](#-severity-level)
 //!   - [... multiple related errors](#-multiple-related-errors)
 //!   - [... delayed source code](#-delayed-source-code)
 //!   - [... handler options](#-handler-options)
@@ -424,7 +426,7 @@
 //! }
 //! ```
 //!
-//! #### ... help text
+//! ### ... help text
 //! `miette` provides two facilities for supplying help text for your errors:
 //!
 //! The first is the `#[help()]` format attribute that applies to structs or
@@ -460,6 +462,19 @@
 //! };
 //! ```
 //!
+//! ### ... severity level
+//! `miette` provides a way to set the severity level of a diagnostic.
+//!
+//! ```rust
+//! use miette::Diagnostic;
+//! use thiserror::Error;
+//!
+//! #[derive(Debug, Diagnostic, Error)]
+//! #[error("welp")]
+//! #[diagnostic(severity(Warning))]
+//! struct Foo;
+//! ```
+//!
 //! ### ... multiple related errors
 //!
 //! `miette` supports collecting multiple errors into a single diagnostic, and
@@ -636,7 +651,7 @@
 //!
 //! let source = "2 + 2 * 2 = 8".to_string();
 //! let report = miette!(
-//!   labels = vec[
+//!   labels = vec![
 //!       LabeledSpan::at(12..13, "this should be 6"),
 //!   ],
 //!   help = "'*' has greater precedence than '+'",

From 24a7bf4f4e9305b7a0d55d68d9abc57e49bee4fc Mon Sep 17 00:00:00 2001
From: Nahor <nahor.j+github@gmail.com>
Date: Thu, 7 Mar 2024 12:20:08 -0800
Subject: [PATCH 63/67] ci(doc consistency): check that lib.rs and README.md
 are consistent (#353)

---
 .github/workflows/ci.yml | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 7ab9326..233b6b4 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -16,6 +16,12 @@ jobs:
         with:
           toolchain: stable
           components: rustfmt
+      - name: Install cargo-readme
+        run: cargo install cargo-readme
+      - name: Check doc consistency
+        shell: bash
+        run: diff -q README.md <(cargo readme)
+            || { echo "::error::Update lib.rs then use cargo-readme to update README.md"; exit 1; }
       - name: rustfmt
         run: cargo fmt --all -- --check
       - name: docs

From ff7baae70c7394320e65c8d9d835224bd968a057 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kat=20March=C3=A1n?= <kzm@zkat.tech>
Date: Thu, 7 Mar 2024 12:21:18 -0800
Subject: [PATCH 64/67] docs: update changelog

---
 CHANGELOG.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 47d16bd..b179baa 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,18 @@
 # `miette` Release Changelog
 
+<a name="7.2.0"></a>
+## 7.2.0 (2024-03-07)
+
+### Features
+
+* **wasm:** add feature "fancy-no-syscall" for wasm targets (#349) ([328bf379](https://github.com/zkat/miette/commit/328bf3792213fc0bed94e72a39acb722b65141dd))
+
+### Bug Fixes
+
+* **label-collections:** Label collection fixes and cleanup (#343) ([75fea093](https://github.com/zkat/miette/commit/75fea0935e495d0215518c80d32dd820910982e3))
+* **invalid span:** skip the snippet when read_span fails (#347) ([7d9dfc6e](https://github.com/zkat/miette/commit/7d9dfc6e8e591f9606c3da55bd8465962358b20f))
+* **redundant-import:** fix a warning and CI failure in nightly (#348) ([6ea86a22](https://github.com/zkat/miette/commit/6ea86a2248854acf88df345814b6c97d31b8b4d9))
+
 <a name="7.1.0"></a>
 ## 7.1.0 (2024-02-16)
 

From ca646f3119790900c737ee8620d12ca8867c3bb4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kat=20March=C3=A1n?= <kzm@zkat.tech>
Date: Thu, 7 Mar 2024 12:21:32 -0800
Subject: [PATCH 65/67] chore: Release

---
 Cargo.toml               | 4 ++--
 miette-derive/Cargo.toml | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/Cargo.toml b/Cargo.toml
index 3fefb43..057bd9e 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "miette"
-version = "7.1.0"
+version = "7.2.0"
 authors = ["Kat Marchán <kzm@zkat.tech>"]
 description = "Fancy diagnostic reporting library and protocol for us mere mortals who aren't compiler hackers."
 categories = ["rust-patterns"]
@@ -14,7 +14,7 @@ exclude = ["images/", "tests/", "miette-derive/"]
 
 [dependencies]
 thiserror = "1.0.56"
-miette-derive = { path = "miette-derive", version = "=7.1.0", optional = true }
+miette-derive = { path = "miette-derive", version = "=7.2.0", optional = true }
 unicode-width = "0.1.11"
 cfg-if = "1.0.0"
 
diff --git a/miette-derive/Cargo.toml b/miette-derive/Cargo.toml
index e18f221..e8082a0 100644
--- a/miette-derive/Cargo.toml
+++ b/miette-derive/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "miette-derive"
-version = "7.1.0"
+version = "7.2.0"
 authors = ["Kat Marchán <kzm@zkat.tech>"]
 edition = "2018"
 license = "Apache-2.0"

From 3eabbcebf113d1d620a6a3f98e8a455414ed3042 Mon Sep 17 00:00:00 2001
From: Brooks Rady <b.j.rady@gmail.com>
Date: Wed, 27 Mar 2024 16:20:06 -0700
Subject: [PATCH 66/67] fix(graphical): fix nested error wrapping (#358)

Fixes: https://github.com/zkat/miette/issues/333
---
 src/eyreish/wrapper.rs                |  41 ------
 src/handlers/graphical.rs             |  15 +-
 tests/derive.rs                       |   6 +
 tests/graphical.rs                    | 191 +++++++++++++++++++++++---
 tests/test_diagnostic_source_macro.rs |  19 ++-
 5 files changed, 200 insertions(+), 72 deletions(-)

diff --git a/src/eyreish/wrapper.rs b/src/eyreish/wrapper.rs
index 6e65eb7..d940fed 100644
--- a/src/eyreish/wrapper.rs
+++ b/src/eyreish/wrapper.rs
@@ -6,35 +6,9 @@ use crate::{Diagnostic, LabeledSpan, Report, SourceCode};
 
 use crate as miette;
 
-#[repr(transparent)]
-pub(crate) struct DisplayError<M>(pub(crate) M);
-
 #[repr(transparent)]
 pub(crate) struct MessageError<M>(pub(crate) M);
 
-pub(crate) struct NoneError;
-
-impl<M> Debug for DisplayError<M>
-where
-    M: Display,
-{
-    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
-        Display::fmt(&self.0, f)
-    }
-}
-
-impl<M> Display for DisplayError<M>
-where
-    M: Display,
-{
-    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
-        Display::fmt(&self.0, f)
-    }
-}
-
-impl<M> StdError for DisplayError<M> where M: Display + 'static {}
-impl<M> Diagnostic for DisplayError<M> where M: Display + 'static {}
-
 impl<M> Debug for MessageError<M>
 where
     M: Display + Debug,
@@ -56,21 +30,6 @@ where
 impl<M> StdError for MessageError<M> where M: Display + Debug + 'static {}
 impl<M> Diagnostic for MessageError<M> where M: Display + Debug + 'static {}
 
-impl Debug for NoneError {
-    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
-        Debug::fmt("Option was None", f)
-    }
-}
-
-impl Display for NoneError {
-    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
-        Display::fmt("Option was None", f)
-    }
-}
-
-impl StdError for NoneError {}
-impl Diagnostic for NoneError {}
-
 #[repr(transparent)]
 pub(crate) struct BoxedError(pub(crate) Box<dyn Diagnostic + Send + Sync>);
 
diff --git a/src/handlers/graphical.rs b/src/handlers/graphical.rs
index a4474f9..9c1d7ab 100644
--- a/src/handlers/graphical.rs
+++ b/src/handlers/graphical.rs
@@ -1,7 +1,7 @@
 use std::fmt::{self, Write};
 
 use owo_colors::{OwoColorize, Style, StyledList};
-use unicode_width::UnicodeWidthChar;
+use unicode_width::{UnicodeWidthChar, UnicodeWidthStr};
 
 use crate::diagnostic_chain::{DiagnosticChain, ErrorKind};
 use crate::handlers::theme::*;
@@ -225,7 +225,7 @@ impl GraphicalReportHandler {
         self.render_related(f, diagnostic, src)?;
         if let Some(footer) = &self.footer {
             writeln!(f)?;
-            let width = self.termwidth.saturating_sub(4);
+            let width = self.termwidth.saturating_sub(2);
             let mut opts = textwrap::Options::new(width)
                 .initial_indent("  ")
                 .subsequent_indent("  ")
@@ -265,7 +265,6 @@ impl GraphicalReportHandler {
             );
             write!(header, "{}", link)?;
             writeln!(f, "{}", header)?;
-            writeln!(f)?;
         } else if let Some(code) = diagnostic.code() {
             write!(header, "{}", code.style(severity_style),)?;
             if self.links == LinkStyle::Text && diagnostic.url().is_some() {
@@ -273,8 +272,8 @@ impl GraphicalReportHandler {
                 write!(header, " ({})", url.style(self.theme.styles.link))?;
             }
             writeln!(f, "{}", header)?;
-            writeln!(f)?;
         }
+        writeln!(f)?;
         Ok(())
     }
 
@@ -354,8 +353,12 @@ impl GraphicalReportHandler {
                         inner_renderer.footer = None;
                         // Cause chains are already flattened, so don't double-print the nested error
                         inner_renderer.with_cause_chain = false;
+                        // Since everything from here on is indented, shrink the virtual terminal
+                        inner_renderer.termwidth -= rest_indent.width();
                         inner_renderer.render_report(&mut inner, diag)?;
 
+                        // If there was no header, remove the leading newline
+                        let inner = inner.trim_start_matches('\n');
                         writeln!(f, "{}", self.wrap(&inner, opts))?;
                     }
                     ErrorKind::StdError(err) => {
@@ -370,7 +373,7 @@ impl GraphicalReportHandler {
 
     fn render_footer(&self, f: &mut impl fmt::Write, diagnostic: &(dyn Diagnostic)) -> fmt::Result {
         if let Some(help) = diagnostic.help() {
-            let width = self.termwidth.saturating_sub(4);
+            let width = self.termwidth.saturating_sub(2);
             let initial_indent = "  help: ".style(self.theme.styles.help).to_string();
             let mut opts = textwrap::Options::new(width)
                 .initial_indent(&initial_indent)
@@ -398,8 +401,8 @@ impl GraphicalReportHandler {
             let mut inner_renderer = self.clone();
             // Re-enable the printing of nested cause chains for related errors
             inner_renderer.with_cause_chain = true;
-            writeln!(f)?;
             for rel in related {
+                writeln!(f)?;
                 match rel.severity() {
                     Some(Severity::Error) | None => write!(f, "Error: ")?,
                     Some(Severity::Warning) => write!(f, "Warning: ")?,
diff --git a/tests/derive.rs b/tests/derive.rs
index ac29eee..aa631dc 100644
--- a/tests/derive.rs
+++ b/tests/derive.rs
@@ -6,12 +6,14 @@ fn related() {
     #[derive(Error, Debug, Diagnostic)]
     #[error("welp")]
     #[diagnostic(code(foo::bar::baz))]
+    #[allow(dead_code)]
     struct Foo {
         #[related]
         related: Vec<Baz>,
     }
 
     #[derive(Error, Debug, Diagnostic)]
+    #[allow(dead_code)]
     enum Bar {
         #[error("variant1")]
         #[diagnostic(code(foo::bar::baz))]
@@ -29,6 +31,7 @@ fn related() {
 
     #[derive(Error, Debug, Diagnostic)]
     #[error("welp2")]
+    #[allow(dead_code)]
     struct Baz;
 }
 
@@ -37,6 +40,7 @@ fn related_report() {
     #[derive(Error, Debug, Diagnostic)]
     #[error("welp")]
     #[diagnostic(code(foo::bar::baz))]
+    #[allow(dead_code)]
     struct Foo {
         #[related]
         related: Vec<Report>,
@@ -288,6 +292,7 @@ fn test_snippet_named_struct() {
     #[derive(Debug, Diagnostic, Error)]
     #[error("welp")]
     #[diagnostic(code(foo::bar::baz))]
+    #[allow(dead_code)]
     struct Foo<'a> {
         #[source_code]
         src: &'a str,
@@ -310,6 +315,7 @@ fn test_snippet_unnamed_struct() {
     #[derive(Debug, Diagnostic, Error)]
     #[error("welp")]
     #[diagnostic(code(foo::bar::baz))]
+    #[allow(dead_code)]
     struct Foo<'a>(
         #[source_code] &'a str,
         #[label("{0}")] SourceSpan,
diff --git a/tests/graphical.rs b/tests/graphical.rs
index 4763117..c6b5e1a 100644
--- a/tests/graphical.rs
+++ b/tests/graphical.rs
@@ -59,14 +59,15 @@ fn word_wrap_options() -> Result<(), MietteError> {
     let out =
         fmt_report_with_settings(Report::msg("abcdefghijklmnopqrstuvwxyz"), |handler| handler);
 
-    let expected = "  × abcdefghijklmnopqrstuvwxyz\n".to_string();
+    let expected = "\n  × abcdefghijklmnopqrstuvwxyz\n".to_string();
     assert_eq!(expected, out);
 
     // A long word can break with a smaller width
     let out = fmt_report_with_settings(Report::msg("abcdefghijklmnopqrstuvwxyz"), |handler| {
         handler.with_width(10)
     });
-    let expected = r#"  × abcd
+    let expected = r#"
+  × abcd
   │ efgh
   │ ijkl
   │ mnop
@@ -81,7 +82,7 @@ fn word_wrap_options() -> Result<(), MietteError> {
     let out = fmt_report_with_settings(Report::msg("abcdefghijklmnopqrstuvwxyz"), |handler| {
         handler.with_width(10).with_break_words(false)
     });
-    let expected = "  × abcdefghijklmnopqrstuvwxyz\n".to_string();
+    let expected = "\n  × abcdefghijklmnopqrstuvwxyz\n".to_string();
     assert_eq!(expected, out);
 
     // Breaks should start at the boundary of each word if possible
@@ -89,7 +90,8 @@ fn word_wrap_options() -> Result<(), MietteError> {
         Report::msg("12 123 1234 12345 123456 1234567 1234567890"),
         |handler| handler.with_width(10),
     );
-    let expected = r#"  × 12
+    let expected = r#"
+  × 12
   │ 123
   │ 1234
   │ 1234
@@ -110,7 +112,8 @@ fn word_wrap_options() -> Result<(), MietteError> {
         Report::msg("12 123 1234 12345 123456 1234567 1234567890"),
         |handler| handler.with_width(10).with_break_words(false),
     );
-    let expected = r#"  × 12
+    let expected = r#"
+  × 12
   │ 123
   │ 1234
   │ 12345
@@ -126,7 +129,8 @@ fn word_wrap_options() -> Result<(), MietteError> {
         Report::msg("a-b a-b-c a-b-c-d a-b-c-d-e a-b-c-d-e-f a-b-c-d-e-f-g a-b-c-d-e-f-g-h"),
         |handler| handler.with_width(10).with_break_words(false),
     );
-    let expected = r#"  × a-b
+    let expected = r#"
+  × a-b
   │ a-b-
   │ c a-
   │ b-c-
@@ -158,7 +162,8 @@ fn word_wrap_options() -> Result<(), MietteError> {
                 .with_word_splitter(textwrap::WordSplitter::NoHyphenation)
         },
     );
-    let expected = r#"  × a-b
+    let expected = r#"
+  × a-b
   │ a-b-c
   │ a-b-c-d
   │ a-b-c-d-e
@@ -174,7 +179,8 @@ fn word_wrap_options() -> Result<(), MietteError> {
         Report::msg("a/b a/b/c a/b/c/d a/b/c/d/e a/b/c/d/e/f a/b/c/d/e/f/g a/b/c/d/e/f/g/h"),
         |handler| handler.with_width(10).with_break_words(false),
     );
-    let expected = r#"  × a/b
+    let expected = r#"
+  × a/b
   │ a/b/
   │ c a/
   │ b/c/
@@ -206,7 +212,8 @@ fn word_wrap_options() -> Result<(), MietteError> {
                 .with_word_separator(textwrap::WordSeparator::AsciiSpace)
         },
     );
-    let expected = r#"  × a/b
+    let expected = r#"
+  × a/b
   │ a/b/c
   │ a/b/c/d
   │ a/b/c/d/e
@@ -227,7 +234,8 @@ fn wrap_option() -> Result<(), MietteError> {
         Report::msg("abc def ghi jkl mno pqr stu vwx yz abc def ghi jkl mno pqr stu vwx yz"),
         |handler| handler.with_width(15),
     );
-    let expected = r#"  × abc def
+    let expected = r#"
+  × abc def
   │ ghi jkl
   │ mno pqr
   │ stu vwx
@@ -246,7 +254,7 @@ fn wrap_option() -> Result<(), MietteError> {
         |handler| handler.with_width(15).with_wrap_lines(false),
     );
     let expected =
-        "  × abc def ghi jkl mno pqr stu vwx yz abc def ghi jkl mno pqr stu vwx yz\n".to_string();
+        "\n  × abc def ghi jkl mno pqr stu vwx yz abc def ghi jkl mno pqr stu vwx yz\n".to_string();
     assert_eq!(expected, out);
 
     // Then, user-defined new lines should be preserved wrapping is disabled
@@ -254,7 +262,8 @@ fn wrap_option() -> Result<(), MietteError> {
       Report::msg("abc def ghi jkl mno pqr stu vwx yz\nabc def ghi jkl mno pqr stu vwx yz\nabc def ghi jkl mno pqr stu vwx yz"),
       |handler| handler.with_width(15).with_wrap_lines(false),
   );
-    let expected = r#"  × abc def ghi jkl mno pqr stu vwx yz
+    let expected = r#"
+  × abc def ghi jkl mno pqr stu vwx yz
   │ abc def ghi jkl mno pqr stu vwx yz
   │ abc def ghi jkl mno pqr stu vwx yz
 "#
@@ -264,6 +273,143 @@ fn wrap_option() -> Result<(), MietteError> {
     Ok(())
 }
 
+#[test]
+fn wrapping_nested_errors() -> Result<(), MietteError> {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("This is the parent error, the error withhhhh the children, kiddos, pups, as it were, and so on...")]
+    #[diagnostic(
+        code(mama::error),
+        help(
+            "try doing it better next time? I mean, you could have also done better thisssss time, but no?"
+        )
+    )]
+    struct MamaError {
+        #[diagnostic_source]
+        baby: BabyError,
+    }
+
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("Wah wah: I may be small, but I'll cause a proper bout of trouble — justt try wrapping this mess of a line, buddo!")]
+    #[diagnostic(
+        code(baby::error),
+        help(
+            "it cannot be helped... woulddddddd you really want to get rid of an error that's so cute?"
+        )
+    )]
+    struct BabyError;
+
+    let err = MamaError { baby: BabyError };
+    let out = fmt_report_with_settings(err.into(), |handler| handler.with_width(50));
+    let expected = r#"mama::error
+
+  × This is the parent error, the error withhhhh
+  │ the children, kiddos, pups, as it were, and
+  │ so on...
+  ╰─▶ baby::error
+      
+        × Wah wah: I may be small, but I'll
+        │ cause a proper bout of trouble — justt
+        │ try wrapping this mess of a line,
+        │ buddo!
+        help: it cannot be helped... woulddddddd
+              you really want to get rid of an
+              error that's so cute?
+      
+  help: try doing it better next time? I mean,
+        you could have also done better thisssss
+        time, but no?
+"#;
+    assert_eq!(expected, out);
+    Ok(())
+}
+
+#[test]
+fn wrapping_related_errors() -> Result<(), MietteError> {
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("This is the parent error, the error withhhhh the children, kiddos, pups, as it were, and so on...")]
+    #[diagnostic(
+        code(mama::error),
+        help(
+            "try doing it better next time? I mean, you could have also done better thisssss time, but no?"
+        )
+    )]
+    struct MamaError {
+        #[diagnostic_source]
+        baby: BrotherError,
+    }
+
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("Welcome to the brother-error brotherhood — where all of the wee baby errors join into a formidable force")]
+    #[diagnostic(code(brother::error))]
+    struct BrotherError {
+        #[related]
+        brethren: Vec<Box<dyn Diagnostic + Send + Sync>>,
+    }
+
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("Wah wah: I may be small, but I'll cause a proper bout of trouble — justt try wrapping this mess of a line, buddo!")]
+    #[diagnostic(help(
+        "it cannot be helped... woulddddddd you really want to get rid of an error that's so cute?"
+    ))]
+    struct BabyError;
+
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("Wah wah: I may be small, but I'll cause a proper bout of trouble — justt try wrapping this mess of a line, buddo!")]
+    #[diagnostic(severity(Warning))]
+    struct BabyWarning;
+
+    #[derive(Debug, Diagnostic, Error)]
+    #[error("Wah wah: I may be small, but I'll cause a proper bout of trouble — justt try wrapping this mess of a line, buddo!")]
+    #[diagnostic(severity(Advice))]
+    struct BabyAdvice;
+
+    let err = MamaError {
+        baby: BrotherError {
+            brethren: vec![BabyError.into(), BabyWarning.into(), BabyAdvice.into()],
+        },
+    };
+    let out = fmt_report_with_settings(err.into(), |handler| handler.with_width(50));
+    let expected = r#"mama::error
+
+  × This is the parent error, the error withhhhh
+  │ the children, kiddos, pups, as it were, and
+  │ so on...
+  ╰─▶ brother::error
+      
+        × Welcome to the brother-error
+        │ brotherhood — where all of the wee
+        │ baby errors join into a formidable
+        │ force
+      
+      Error:
+        × Wah wah: I may be small, but I'll
+        │ cause a proper bout of trouble — justt
+        │ try wrapping this mess of a line,
+        │ buddo!
+        help: it cannot be helped... woulddddddd
+              you really want to get rid of an
+              error that's so cute?
+      
+      Warning:
+        ⚠ Wah wah: I may be small, but I'll
+        │ cause a proper bout of trouble — justt
+        │ try wrapping this mess of a line,
+        │ buddo!
+      
+      Advice:
+        ☞ Wah wah: I may be small, but I'll
+        │ cause a proper bout of trouble — justt
+        │ try wrapping this mess of a line,
+        │ buddo!
+      
+  help: try doing it better next time? I mean,
+        you could have also done better thisssss
+        time, but no?
+"#;
+    assert_eq!(expected, out);
+    Ok(())
+}
+
 #[test]
 fn empty_source() -> Result<(), MietteError> {
     #[derive(Debug, Diagnostic, Error)]
@@ -326,7 +472,8 @@ if true {
     let out = fmt_report(err.into());
     println!("Error: {}", out);
 
-    let expected = r#"  × oops!
+    let expected = r#"
+  × oops!
    ╭─[issue:1:1]
  1 │ ╭─▶ if true {
  2 │ │       a
@@ -361,7 +508,8 @@ fn single_line_highlight_span_full_line() {
     let out = fmt_report(err.into());
     println!("Error: {}", out);
 
-    let expected = r#"  × oops!
+    let expected = r#"
+  × oops!
    ╭─[issue:2:1]
  1 │ source
  2 │ text
@@ -1411,7 +1559,6 @@ Error: oops::my::bad
  2 │   text
    ╰────
   help: try doing it better next time?
-
 "#
     .trim_start()
     .to_string();
@@ -1578,6 +1725,7 @@ Error: oops::my::related::error
  2 │   text
    ╰────
   help: try doing it better next time?
+
 Warning: oops::my::related::warning
 
   ⚠ oops!
@@ -1588,6 +1736,7 @@ Warning: oops::my::related::warning
  2 │   text
    ╰────
   help: try doing it better next time?
+
 Advice: oops::my::related::advice
 
   ☞ oops!
@@ -1623,7 +1772,8 @@ fn zero_length_eol_span() {
     let out = fmt_report(err.into());
     println!("Error: {}", out);
 
-    let expected = r#"  × oops!
+    let expected = r#"
+  × oops!
    ╭─[issue:2:1]
  1 │ this is the first line
  2 │ this is the second line
@@ -1657,7 +1807,8 @@ fn primary_label() {
     println!("Error: {}", out);
 
     // line 2 should be the primary, not line 1
-    let expected = r#"  × oops!
+    let expected = r#"
+  × oops!
    ╭─[issue:2:2]
  1 │ this is the first line
    ·   ────
@@ -1808,7 +1959,8 @@ fn syntax_highlighter() {
     GraphicalReportHandler::new_themed(GraphicalTheme::unicode())
         .render_report(&mut out, &err)
         .unwrap();
-    let expected = r#"  × This is an error
+    let expected = r#"
+  × This is an error
    ╭─[hello_world:2:5]
  1 │ fn main() {
  2 │     println!("Hello, World!");
@@ -1862,7 +2014,8 @@ fn syntax_highlighter_on_real_file() {
         .unwrap();
 
     let expected = format!(
-        r#"  × This is an error
+        r#"
+  × This is an error
       ╭─[{filename}:{l2}:{CO}]
  {l1} │ 
  {l2} │     let (filename, line) = (file!(), line!() as usize);
diff --git a/tests/test_diagnostic_source_macro.rs b/tests/test_diagnostic_source_macro.rs
index 939812c..4f15ea0 100644
--- a/tests/test_diagnostic_source_macro.rs
+++ b/tests/test_diagnostic_source_macro.rs
@@ -104,7 +104,8 @@ fn test_diagnostic_source_pass_extra_info() {
         .render_report(&mut out, &diag)
         .unwrap();
     println!("Error: {}", out);
-    let expected = r#"  × TestError
+    let expected = r#"
+  × TestError
   ╰─▶   × A complex error happened
          ╭─[1:2]
        1 │ Hello
@@ -138,7 +139,8 @@ fn test_diagnostic_source_is_output() {
         .unwrap();
     println!("{}", out);
 
-    let expected = r#"  × TestError
+    let expected = r#"
+  × TestError
   ╰─▶   × A complex error happened
          ╭────
        1 │ right here
@@ -186,7 +188,8 @@ fn test_nested_diagnostic_source_is_output() {
         .unwrap();
     println!("{}", out);
 
-    let expected = r#"  × A nested error happened
+    let expected = r#"
+  × A nested error happened
   ├─▶   × TestError
   │   
   ╰─▶   × A complex error happened
@@ -252,10 +255,12 @@ fn test_nested_cause_chains_for_related_errors_are_output() {
         .unwrap();
     println!("{}", out);
 
-    let expected = r#"  × A nested error happened
+    let expected = r#"
+  × A nested error happened
   ╰─▶   × A multi-error happened
       
-      Error:   × A nested error happened
+      Error:
+        × A nested error happened
         ├─▶   × TestError
         │
         ╰─▶   × A complex error happened
@@ -271,7 +276,9 @@ fn test_nested_cause_chains_for_related_errors_are_output() {
          ·       ──┬─
          ·         ╰── here
          ╰────
-      Error:   × A complex error happened
+      
+      Error:
+        × A complex error happened
          ╭────
        1 │ You're actually a mess
          ·    ──┬─

From 7b42b12c5f6316322ce79c59bcb9e99f5d49edb8 Mon Sep 17 00:00:00 2001
From: TrapinchO <67415128+TrapinchO@users.noreply.github.com>
Date: Wed, 3 Apr 2024 22:31:03 +0200
Subject: [PATCH 67/67] fix(docs): updated example image (fixes #111) (#270)

---
 README.md                      |  20 +++++++++++---------
 images/single-line-example.png | Bin 298553 -> 55411 bytes
 2 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index fe69ce2..b58cc94 100644
--- a/README.md
+++ b/README.md
@@ -13,18 +13,20 @@ can print out like this (or in any format you like!):
 
 <img src="https://raw.githubusercontent.com/zkat/miette/main/images/serde_json.png" alt="Hi! miette also includes a screen-reader-oriented diagnostic printer that's enabled in various situations, such as when you use NO_COLOR or CLICOLOR settings, or on CI. This behavior is also fully configurable and customizable. For example, this is what this particular diagnostic will look like when the narrated printer is enabled:
 \
-Error: Received some bad JSON from the source. Unable to parse.
-    Caused by: missing field `foo` at line 1 column 1700
+diagnostic error code: oops::my::bad (link)
+Error: oops!
 \
-Begin snippet for https://api.nuget.org/v3/registration5-gz-semver2/json.net/index.json starting
-at line 1, column 1659
+Begin snippet for bad_file.rs starting
+at line 2, column 3
 \
-snippet line 1: gs&quot;:[&quot;json&quot;],&quot;title&quot;:&quot;&quot;,&quot;version&quot;:&quot;1.0.0&quot;},&quot;packageContent&quot;:&quot;https://api.nuget.o
-    highlight starting at line 1, column 1699: last parsing location
+snippet line 1: source
 \
-diagnostic help: This is a bug. It might be in ruget, or it might be in the
-source you're using, but it's definitely a bug and should be reported.
-diagnostic error code: ruget::api::bad_json
+snippet line 2:  text
+    highlight starting at line 1, column 3: This bit here
+\
+snippet line 3: here
+\
+diagnostic help: try doing it better next time?
 " />
 
 > **NOTE: You must enable the `"fancy"` crate feature to get fancy report
diff --git a/images/single-line-example.png b/images/single-line-example.png
index 32a0dd5e101ba11d1a1da4d43b0423b73c643415..2c02b448537434300101be8a7b5bac9e13ec4c07 100644
GIT binary patch
literal 55411
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

literal 298553
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