tinymist-world 0.15.0-rc2

Typst's World implementation for tinymist.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

//! The diagnostic utilities.

use ecow::EcoString;

use std::str::FromStr;

use codespan_reporting::diagnostic::{Diagnostic, Label};
use codespan_reporting::term;
use codespan_reporting::term::termcolor::{NoColor, WriteColor};
use tinymist_std::Result;
use tinymist_vfs::FileId;
use typst::WorldExt;
use typst::diag::{Severity, SourceDiagnostic, StrResult, eco_format};
use typst::syntax::DiagSpan;

use crate::{CodeSpanReportWorld, DiagnosticFormat, SourceWorld};

/// Prints diagnostic messages to a string.
pub fn print_diagnostics_to_string<'d, 'files>(
    world: &'files dyn SourceWorld,
    errors: impl Iterator<Item = &'d SourceDiagnostic>,
    diagnostic_format: DiagnosticFormat,
) -> StrResult<EcoString> {
    let mut w = NoColor::new(vec![]);

    print_diagnostics_to(world, errors, &mut w, diagnostic_format)
        .map_err(|e| eco_format!("failed to print diagnostics to string: {e}"))?;
    let output = EcoString::from_str(
        std::str::from_utf8(&w.into_inner())
            .map_err(|e| eco_format!("failed to convert diagnostics to string: {e}"))?,
    )
    .unwrap_or_default();
    Ok(output)
}

/// Prints diagnostic messages to a writer.
pub fn print_diagnostics_to<'d, 'files>(
    world: &'files dyn SourceWorld,
    errors: impl Iterator<Item = &'d SourceDiagnostic>,
    w: &mut impl WriteColor,
    diagnostic_format: DiagnosticFormat,
) -> Result<(), codespan_reporting::files::Error> {
    let world = CodeSpanReportWorld::new(world);

    let mut config = term::Config {
        tab_width: 2,
        ..Default::default()
    };
    if diagnostic_format == DiagnosticFormat::Short {
        config.display_style = term::DisplayStyle::Short;
    }

    for diagnostic in errors {
        let diag = match diagnostic.severity {
            Severity::Error => Diagnostic::error(),
            Severity::Warning => Diagnostic::warning(),
        }
        .with_message(diagnostic.message.clone())
        .with_notes(
            diagnostic
                .hints
                .iter()
                .map(|e| (eco_format!("hint: {}", e.v)).into())
                .collect(),
        )
        .with_labels(label(world.world, diagnostic.span).into_iter().collect());

        term::emit(w, &config, &world, &diag)?;

        // Stacktrace-like helper diagnostics.
        for point in &diagnostic.trace {
            let message = point.v.to_string();
            let help = Diagnostic::help()
                .with_message(message)
                .with_labels(label(world.world, point.span).into_iter().collect());

            term::emit(w, &config, &world, &help)?;
        }
    }

    Ok(())
}

/// Creates a label for a span.
fn label(world: &dyn SourceWorld, span: impl Into<DiagSpan>) -> Option<Label<FileId>> {
    let span = span.into();
    Some(Label::primary(span.id()?, world.range(span)?))
}