feat(rome_console): add a Codespan utility struct to display annotated code fragments

[leops]

Summary

This PR adds a simplified copy of the code in crates/rome_diagnostics/src/codespan to rome_console, exposing a Codespan struct intended to display annotated code as markup in the console. This is the first step in a refactor of Diagnostic to make the struct implement rome_console::fmt::Display on top of common markup and utilities, essentially turning the rendering logic for diagnostics into the following markup:

markup! {
    {level}"["{code}"]: "{message}"\n"
    {codespan}
    "Suggested fix:\n"
    {diff}
}

Example

let source = SourceFile::new(SOURCE);

let mut codespan = Codespan::new(
    &source,
    Severity::Error,
    Some(Locus::FileLocation {
        name: String::from("file_name"),
        location: Location {
            line_number: 2,
            column_number: 12,
        },
    }),
);

codespan.add_label(Label {
    style: LabelStyle::Primary,
    range: 40..55,
    message: markup! {
        <Emphasis>"Important"</Emphasis>" message"
    },
})?;

codespan.add_label(Label {
    style: LabelStyle::Secondary,
    range: 71..99,
    message: markup! {
        "Multiline message"
    },
})?;

codespan.add_label(Label {
    style: LabelStyle::Secondary,
    range: 100..109,
    message: markup! {
        "Secondary message"
    },
})?;

[ematipico]

Suggested change

	///! This module if a fork of https://github.com/brendanzab/codespan,
	/// adapted to use the `rome_console` markup for formatting
	//! This module if a fork of https://github.com/brendanzab/codespan ,
	//! adapted to use the `rome_console` markup for formatting

[ematipico]

Could we add this project to the credits section? https://rome.tools/credits/#forks

[ematipico]

What's the the difference between these two? How do we know when to use one or the other? Should we add it to the documentation?

[leops]

The basic difference seem to be that Note is printed in green and is converted to the Hint severity in the LSP, while Help is printed in blue and is converted to the Information severity in the LSP. Overall they don't seem to be used much yet, a quick grep over the entire codebase returned no usage of the help severity while the note severity is used for only two diagnostics, and even then it's in footer notes and not in actual codespan labels.

[ematipico]

What's the difference between these two?

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Pages

Latest commit:	fd2da3c
Status:	✅  Deploy successful!
Preview URL:	https://b7476c81.tools-8rn.pages.dev

View logs