bezel-markdown 0.1.11

A Notion-style block document model for gpui — markdown in, markdown out
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

//! Who colors a fenced block.
//!
//! `markdown` names no highlighter. The one this crate would otherwise reach
//! for is tree-sitter, whose C cannot be built for `wasm32-unknown-unknown` —
//! there is no libc to compile it against — so a web build would carry a
//! dependency it can never link. Installed once at boot like the theme
//! palette, and read at paint.

use std::ops::Range;

use gpui::{App, Global, SharedString};
use theme::HighlightKind;

/// Spans over `code`, in bytes. `None` for a language the caller cannot color.
pub type Highlighter = fn(language: &str, code: &str) -> Option<Vec<(Range<usize>, HighlightKind)>>;

struct Installed {
    highlighter: Highlighter,
    languages: Vec<SharedString>,
}

impl Global for Installed {}

/// `markdown::set_highlighter(cx, my_highlighter, my_languages)` — call once at
/// boot. Without it every fenced block paints in one plain run, which is what a
/// document looks like before anyone has an opinion about its code.
///
/// The names travel with the function because they are the same fact twice: a
/// picker that offers a language nothing can color is a promise the highlighter
/// does not keep.
pub fn set_highlighter(
    cx: &mut App,
    highlighter: Highlighter,
    languages: impl IntoIterator<Item = impl Into<SharedString>>,
) {
    cx.set_global(Installed {
        highlighter,
        languages: languages.into_iter().map(Into::into).collect(),
    });
}

/// What the installed highlighter can color — the list a language picker
/// offers, empty until someone installs one.
pub fn languages(cx: &App) -> &[SharedString] {
    cx.try_global::<Installed>()
        .map_or(&[], |installed| &installed.languages)
}

pub(crate) fn spans(
    cx: &App,
    language: Option<&str>,
    code: &str,
) -> Option<Vec<(Range<usize>, HighlightKind)>> {
    (cx.try_global::<Installed>()?.highlighter)(language?, code)
}