highlight-spans 0.3.0

Tree-sitter ObjectScript highlight spans as attr/start/end tuples
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

# highlight-spans

`highlight-spans` parses source with Tree-sitter and returns semantic highlight ranges as `(attr_id, start_byte, end_byte)` spans plus an attribute table.

## What You Get

- `SpanHighlighter` for highlighting source bytes or line slices.
- `HighlightResult { attrs, spans }` where:
  - `attrs` maps `attr_id -> capture_name`
  - `spans` contains byte ranges tagged by `attr_id`
- `Grammar` variants:
  - `ObjectScript`
  - `Sql` (using vendored `DerekStride/tree-sitter-sql` grammar/query assets)
  - `Python`
  - `Markdown` (using `tree-sitter-md` block+inline grammar/query constants)
  - `Mdx` (temporary fallback: uses SQL highlighting)

## Quick Example

```rust
use highlight_spans::{Grammar, SpanHighlighter};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut highlighter = SpanHighlighter::new()?;
    let source = b"set x = 42";
    let result = highlighter.highlight(source, Grammar::ObjectScript)?;

    for span in &result.spans {
        let capture = &result.attrs[span.attr_id].capture_name;
        println!("{capture} {}..{}", span.start_byte, span.end_byte);
    }

    Ok(())
}
```

## Typical Next Step

Use `theme-engine` to resolve `capture_name` into styles, then pass styled ranges to a renderer (for example `render-ansi`).