tree-sitter-d2

Table of Contents

• tree-sitter-d2
  • Table of Contents
  • Description
  • Installation
    • Neovim
    • Helix
    • Other editors
  • Showcase
  • Contribution
  • Comparison
    • Better consistency overall
    • Better handling of foreign languages

Description

Tree Sitter grammar for d2lang (github). It's not yet finished, but usable for every-day cases with support for latest features like globs, filters and variables.

The goal is to provide better experience for existing keywords, code blocks injections, folds, etc.

• Better parsing of modern structures - The latest supported version of d2 is v0.7.0.
• Built with nvim-treesitter in mind - We respect and follow its highlight groups.
• Keywords - All keywords from the documentation are treated as such. (Open an issue if any are missing.)
• Tests - We aim to cover all edge cases and examples from the documentation, resulting in more robust parsing. Currently, we have more than 100 tests. (This will be reduced later when the grammar becomes stable.)

I've never done anything remotely close to parsing grammar, so there could be some bad patterns and simply bad code. Feel free to open issues.

Installation

Neovim

via lazy.nvim

{
  "ravsii/tree-sitter-d2",
  dependencies = { "nvim-treesitter/nvim-treesitter" },
  build = "make nvim-install",
  branch = "v0.7.1",
},

[!TIP] We recommend using branch set to the latest release tag instead of main, as we cannot guarantee that there won't be breaking changes, because that's fully on d2 team. But if there are, we simply follow the latest release.

Helix

Fortunately Helix has it's own guide on how to add new languages and grammars.

A quick example for installing d2 would be:

1. Add new language to languages.toml

[[language]]
name = "d2"
scope = "source.git"
file-types = ["d2"]
comment-token = "#"
roots = [""]
indent = { tab-width = 2, unit = "  " }

[[grammar]]
source = { git = "https://github.com/ravsii/tree-sitter-d2", rev = "main" }
name = "d2"

2. hx --grammar fetch && hx --grammar build
3. Add your queries to ~/.config/helix/runtime/queries/d2

~/.config/helix/runtime/queries/d2
├── highlights.scm
├── injections.scm
└── locals.scm

[!WARNING]
We found out that Helix is using tree-sitter v0.22.x which makes it incompatible with this grammar, as it was built using tree-sitter v0.25.x.

If the highlighting doesn't work and :log-open has this error:

Incompatible language version 15. Expected minimum 13, maximum 14

then try using these options

[[grammar]]
source = { git = "https://github.com/ravsii/tree-sitter-d2", rev = "main-helix" }
name = "d2"

For more info see: https://github.com/ravsii/tree-sitter-d2/issues/102

Other editors

If you're using some other editor that's using tree-sitter, please open an issue. Would be great if you could also provide instructions for other how to install it.

Showcase

Tokyo Night Storm theme with CaskaydiaCove font.

Props to Neovim's Tokyo Night theme for supporting pretty much every highlighting group.

https://github.com/user-attachments/assets/a9bd20d0-eb6c-43c2-8e58-7d211d350025

Contribution

See CONTRIBUTION.md

Comparison

This section is outdated and not maintained

Actually, there's another tree-sitter-d2 by pleshevskiy. My project's initial goal was to fix issues his grammar had, but later I realized that his grammar is not maintained and lacks many features d2 has added since then.

Here's a list of comparisons as of v0.2 version of this project, both using Tokyonight Storm theme.

Please note that:

• On the left is our project using Neovim, on the right is pleshevskiy's grammar using Helix (I was unable to install pleshevskiy's grammar in Neovim)
• Some example are my random homework, thus being in Russian, please don't try make sense of them. Thanks! :D

Better consistency overall

Better handling of foreign languages