Tracking issue: language support requests

[clason]

This is a tracking issue collecting requests for new languages to add to nvim-treesitter. If you would like to add a language to the list, comment on this issue with the following information:

• name of the language
• link to an existing tree-sitter parser (if available)
• link to a repository containing queries (if available)
• language grammar description, vim syntax plugin etc. if none of the above exist.

Note: having a language on this list does not mean a maintainer will do the work for adding it; rather this list is meant as guidance for community contributions.

---

Languages needing a PR

(Parsers and simple queries exist already and just need to be included in our list and tested.)

• [x] Proto (#2307)
• [x] Solidity (#1168)
• [x] SQL (#2511)
• [x] org (#2841)
• [ ] TJ's Neovim-specific Lua parser (#543)
• [ ] ReScript
• [ ] gotmpl

Languages needing queries

(A parser exists, but queries for highlights, indent, injections, folds, and/or locals are still missing. Some guidance for writing these can be found in CONTRIBUTING.md and the tree-sitter documentation.)

• [x] Agda (#1431)
• [x] Objective-C (#1824)
• [x] Vimdoc (#2679)

Languages needing parsers

(Not even a parser exists yet; if you are familiar with the language and tree-sitter, consider contributing one. You can also help by searching for new parsers in case someone has created by now.)

• [x] luadoc (comments with emmyLua annotations; similar to jsdoc/phpdoc)
• [x] htmldjango/jinja2
• [ ] ASCIIdoc (#2263)
• [ ] zsh (#655)

[nkrkv]

Hello, great thanks for maintaining this repo! I’d like to promote a new language grammar that is battle-tested enough to this repo, so that programmers who use ReScript can just :TSInstall rescript if they would like to get its support without extra plugin dependencies.

• name of the language: ReScript
• link to an existing tree-sitter parser: https://github.com/nkrkv/nvim-treesitter-rescript/tree/main/tree-sitter-rescript
• link to a repository containing queries: https://github.com/nkrkv/nvim-treesitter-rescript/tree/main/queries/rescript

I’m the maintainer of the nvim-treesitter-rescript repo, and would kindly apply any necessary changes to be applied for nvim-treesitter upstream.

[theHamsta]

Hi @nkrkv! Do you want to create PR?

[nkrkv]

Sure. What points should this PR affect? I see:

• https://github.com/nvim-treesitter/nvim-treesitter/blob/master/lua/nvim-treesitter/parsers.lua
• https://github.com/nvim-treesitter/nvim-treesitter/tree/master/queries
• https://github.com/nvim-treesitter/nvim-treesitter/tree/master/tests/query/highlights

Will it be enough?

[clason]

Also indents tests might be useful (but not required). Maybe take a look at earlier PRs adding parsers.

(Fair warning: I'll hide and/or delete the comments in the near future to keep this tracking issue tidy.)

[dapc11]

Hello, by working with Kubernetes and Helm templates, I would like to request support for the templates used in the workflow. There is already some implementation of it, all praise to ngalaiko for creating it.

• name of the language gotmpl
• link to an existing tree-sitter parser (if available) https://github.com/ngalaiko/tree-sitter-go-template
• link to a repository containing queries (if available) https://github.com/ngalaiko/tree-sitter-go-template/tree/master/queries
• language grammar description, vim syntax plugin etc. if none of the above exist. Golang template documentation

[andykais]

it looks like the sql pr linked at the top of this issue is closed and outdated. This repo https://github.com/m-novikov/tree-sitter-sql is the language parser shown for SQL on the official treesitter website https://tree-sitter.github.io/tree-sitter/ (at least I think this is the official site). What would it take to integrate this parser into nvim-treesitter?

[theHamsta]

@andykais not much. A small addition to lua/parsers.lua and an adaption of https://github.com/m-novikov/tree-sitter-sql/blob/main/queries/highlights.scm to according to our CONTRIBUTING.md

[andykais]

@theHamsta is this sufficient? https://github.com/nvim-treesitter/nvim-treesitter/pull/2511

[illotum]

Jinja

Docs (v3): https://jinja.palletsprojects.com/en/3.1.x/

Implementations (WIP, v2):

• https://github.com/dbt-labs/tree-sitter-jinja2
• https://github.com/theHamsta/tree-sitter-jinja2

Sample Vim plugins (likely v2):

• https://github.com/lepture/vim-jinja
• https://github.com/glench/vim-jinja2-syntax

[glapa-grossklag]

Elsa

• Syntax: https://github.com/ucsd-progsys/elsa
• Repository: https://github.com/glapa-grossklag/tree-sitter-elsa

The syntax specification is a little informal, so let me know if any more information is needed. :)

[ajukraine]

Haxe

• Syntax (described with OCaml): https://github.com/HaxeFoundation/haxe/tree/development/src/syntax
• Vim syntax plugin: https://github.com/jdonaldson/vaxe
• LSP: https://github.com/vshaxe/haxe-language-server
• Official site: https://haxe.org/

[tobil4sk]

Haxe also has a tree-sitter implementation here: https://github.com/vantreeseba/tree-sitter-haxe

[WillEhrendreich]

FSharp

EDIT: @baronfel 's parser is now archived, points to this one instead Current Parser It doesn't appear that anyone has done any queries Language spec's

I would love to contribute, but frankly all of this is WAAAAY over my head.

[mosheavni]

Jenkinsfile

In addition to groovy's syntax, there are additional keywords added by jenkins that would be common on a Jenkinsfile: https://github.com/martinda/Jenkinsfile-vim-syntax

[nwotero]

VHDL

https://github.com/alemuller/tree-sitter-vhdl

[erfanara]

Antlr4 , Antlr3

vim syntax plugins: https://github.com/Joakker/vim-antlr4 https://github.com/dylon/vim-antlr vim syntax file: https://github.com/vim/vim/blob/master/runtime/syntax/antlr.vim

[psliwka]

Cue

https://github.com/eonpatapon/tree-sitter-cue

[bollian]

OpenSCAD

My parser for this seems to be feature complete: https://github.com/bollian/tree-sitter-openscad

I'm willing to maintain support for my parser. Currently I'm looking for guidance on how to write the queries and modules for supporting highlighting, folding, and indentation.

[Akselmo]

QML

I found a plugin for it here https://github.com/peterhoeg/vim-qml

However having it in treesitter would be nice

Edit: Found this pr in treesitter repo: https://github.com/tree-sitter/tree-sitter/pull/1672/commits/38ff9e37fd24402bf2f8f27e9fe64ee7a670d909

That links to this https://github.com/yuja/tree-sitter-qmljs

[tomasky]

Nim lang

Maybe this,no test: https://github.com/haxscramper/tree-sitter-nim Neovim plugin: https://github.com/alaviss/nim.nvim

[mirryi]

ReasonML

• Syntax: https://github.com/ocamllabs/vscode-ocaml-platform/blob/master/syntaxes/reason.json
• Parser (untested): https://github.com/IwanKaramazow/tree-sitter-reason
• Plugins: https://github.com/jordwalke/vim-reasonml, https://github.com/reasonml-editor/vim-reason-plus

[max397574]

LUAP

Parser for lua patterns. This improved readability of patterns a lot in my opinion. https://github.com/vhyrro/tree-sitter-luap

[Decodetalkers]

Mesonbuild

Parse for mesonbuild I think we need the highlight for meson build also.. https://mesonbuild.com/ No gammer so far

[pimvh]

Ansible

---

This exists for VSCode: https://github.com/ansible/ansible-language-server This exists as a CoC extension for vim/nvim: https://github.com/yaegassy/coc-ansible

I think however that a lot of work needs to be done to convert this into treesitter syntax. I would like to help, but need some guidance.

I have now seen the light (and the errors of my ways). Note that Nvim tree is just a parser of a filetype, meaning that a Ansible LSP can use the YAML backend written by Treesitter. Hence, my comment was not really interesting.

Still a Jinja parser has my vote.

[roomtin]

Move

There's a plugin for VSCode: https://github.com/damirka/vscode-move-syntax

But there may be considerable work involved in producing what treesitter requires. I'm happy to help since I'd like to use treesitter on move programs, but like the fellow above, I'd need a bit of guidance for getting started.

[grantmacken]

XQuery

I built, maintain and use this tree-sitter-xquery which can be seen in web tree-sitter playground

• has highlight query scm
• tests for grammar.
• loads of XQuery examples which don't error

[ObserverOfTime]

Stylus

• TS parser: N/A
• Documentation: https://stylus-docs.netlify.app/docs/
• Vim plugin: https://github.com/vio/vim-stylus

Less

• TS parser: N/A
• Documentation: https://lesscss.org/#overview
• Vim plugin: https://github.com/groenewege/vim-less

CoffeeScript

• TS parser: N/A
• Documentation: https://coffeescript.org/#language
• Vim plugin: https://github.com/kchmck/vim-coffee-script

LiveScript

• TS parser: N/A
• Documentation: https://livescript.net/#introduction
• Vim plugin: https://github.com/wsdjeg/vim-livescript

qmake

• TS parser: N/A
• Documentation: https://doc.qt.io/qt-5/qmake-language.html
• Vim plugin: https://github.com/MartinDelille/vim-qmake

Inno Setup Script

• TS parser: N/A
• Documentation: https://jrsoftware.org/ishelp/index.php
• Vim plugin: built-in

PlantUML

• TS parser:
  • https://github.com/lyndsysimon/tree-sitter-plantuml
  • https://github.com/ahlinc/tree-sitter-plantuml
  • https://github.com/Decodetalkers/tree_sitter_plantuml
• Documentation: https://plantuml.com/
• Vim plugin: https://github.com/aklt/plantuml-syntax

✓ NASM

• TS parser: https://github.com/PictElm/tree-sitter-nasm
• Documentation: https://www.nasm.us/xdoc/2.16/html/nasmdoc3.html
• Vim plugin: built-in

Crystal

• TS parser:
  • https://github.com/keidax/tree-sitter-crystal
  • https://github.com/will/tree-sitter-crystal
• Documentation: https://crystal-lang.org/reference/1.8/syntax_and_semantics/index.html
• Vim plugin: https://github.com/jlcrochet/vim-crystal

✓ Smali

• TS parser: https://git.sr.ht/~yotam/tree-sitter-smali
• Documentation: https://github.com/JesusFreke/smali
• Vim plugin: https://github.com/dieterplex/vim-smali

✓ Groovy

• TS parser:
  • https://github.com/codieboomboom/tree-sitter-groovy
  • https://github.com/Decodetalkers/tree-sitter-groovy
• Documentation: https://groovy-lang.org/documentation.html#languagespecification
• Vim plugin: built-in

✓ jq

• TS parser: https://github.com/flurie/tree-sitter-jq
• Documentation: https://stedolan.github.io/jq/manual/#Basicfilters
• Vim plugin: https://github.com/vito-c/jq.vim

[ElDifinitivo]

Nushell

• Grammar: https://github.com/LhKipp/tree-sitter-nu
• Documentation: https://www.nushell.sh/book/command_reference.html

Plugins for vim are already an https://github.com/nushell/nushell/issues/3728

[rosshadden]

Nim lang

Maybe this,no test: https://github.com/haxscramper/tree-sitter-nim Neovim plugin: https://github.com/alaviss/nim.nvim

@tomasky These treesitter projects for Nim exist as well, and looks like they may be may be slightly more mature:

• https://github.com/aMOPel/tree-sitter-nim
• https://github.com/monaqa/tree-sitter-nim

[andy2mrqz]

gitignore

Was looking for this and couldn't find it except in this issue, which referenced a repo with a grammar/some patterns.

• Grammar: https://github.com/shunsambongi/tree-sitter-gitignore
• Patterns: https://github.com/shunsambongi/tree-sitter-gitignore/blob/main/test/corpus/patterns.txt

[theHamsta]

@andy2mrqz do you want to create a PR? I think you can create highlights similar to regex

EDIT: I will try an attempt at this...

[theHamsta]

@ElDifinitivo I Tried to add https://github.com/nushell/nushell.git but it failed to parse a simple test file without errors

[enderger]

@ElDifinitivo I Tried to add https://github.com/nushell/nushell.git but it failed to parse a simple test file without errors

Maybe because that isn't a tree-sitter parser? The parser grammar is here.

[theHamsta]

@enderger I meant to link https://github.com/LhKipp/tree-sitter-nu . https://github.com/LhKipp/tree-sitter-nu didn't work well for me

[enderger]

@enderger I meant to link https://github.com/LhKipp/tree-sitter-nu . https://github.com/LhKipp/tree-sitter-nu didn't work well for me

Ah, alright. We seem to have got it working using the latest version rather than the one used by the Neovim plugin, if it helps.

[LeviticusNelson]

Apex https://github.com/forcedotcom/salesforcedx-vscode/blob/develop/packages/salesforcedx-vscode-apex/syntaxes/apex.configuration.json

[Decodetalkers]

Mesonbuild

Parse for mesonbuild I think we need the highlight for meson build also.. https://mesonbuild.com/ No gammer so far

Now I create one, can it be used? https://github.com/Decodetalkers/tree-sitter-meson

[clason]

make a PR for it

[Popkornium18]

awk

Queries and existing parser can be found here: https://github.com/Beaglefoot/tree-sitter-awk

[DeadlySquad13]

Powershell

Official existing parser can be found here: https://github.com/powershell/tree-sitter-powershell TODO list is huge, though, so I searched for a few materials, hope It helps:

• existing vim syntax files (seems like most of the keywords from todo list are done): https://github.com/PProvost/vim-ps1
• official lanaguage specification: https://docs.microsoft.com/en-us/powershell/scripting/lang-spec/chapter-02?view=powershell-7.2

I don't really know how parsers work so I have troubles adding it to nvim-treesitter. However, I have written some custom queries so feel free to mention me in a PR, I will try to help with improving them.

[Fildo7525]

Bitbake

User manual for bitbake: https://docs.yoctoproject.org/1.6/bitbake-user-manual/bitbake-user-manual.html

https://yal.cc/bb-code-syntax-highlighting-for-notepad/

Links to highlighting: https://github.com/kergoth/vim-bitbake https://github.com/ikoveshnik/bitbake-syntax-highlighter

[folliehiyuki]

Dhall

Homepage: https://dhall-lang.org/ Vim syntax plugin: https://github.com/vmchale/dhall-vim

There is no parser nor queries yet AFAIK.

[Nargonath]

Apache Velocity Template Language (VTL)

Homepage: https://velocity.apache.org/engine/1.7/user-guide.html Vim syntax plugin:

• https://github.com/vim-scripts/velocity.vim
• https://github.com/lepture/vim-velocity

There is no parser nor queries yet AFAIK. FYI This templating language is not bind only to HTML as it's used by AWS with JSON: https://docs.aws.amazon.com/appsync/latest/devguide/resolver-mapping-template-reference-programming-guide.html.

[danielo515]

What is preventing the rescript tree-sitter grammar to be integrated?

[clason]

What is preventing the rescript tree-sitter grammar to be integrated?

Somebody making a PR.

[f3fora]

git-commit

Helix uses a treesitter parser also for git-commit filetype.

Grammar: https://github.com/the-mikedavis/tree-sitter-git-commit

It is somewhat complete but needs testing and highlight queries.

Luckily, Helix has already implemented some queries: https://github.com/helix-editor/helix/tree/master/runtime/queries/git-commit

[gbprod]

git-commit

Helix uses a treesitter parser also for git-commit filetype.

Grammar: https://github.com/the-mikedavis/tree-sitter-git-commit

It is somewhat complete but needs testing and highlight queries.

Luckily, Helix has already implemented some queries: https://github.com/helix-editor/helix/tree/master/runtime/queries/git-commit

I've looked at this parser in order to add this in nvim-treesitter but I have a mixed opinion. I'm french and I use git in french and this parser doesn't works at all in this case, I've notice this to the author https://github.com/the-mikedavis/tree-sitter-git-commit/issues/4 and I don't think he will fix that.

So, I'm thinking about implementing myself a gitcommit parser that will works with all languages (I hope)...

[nat-418]

Tcl / Tk

• Homepage: https://www.tcl.tk/
• "Grammar": https://wiki.tcl-lang.org/page/BNF+for+Tcl

[clason]

https://github.com/lewis6991/tree-sitter-tcl

[colin-heffernan]

Yuck

Yuck is used to configure Elkowar's Wacky Widgets (EWW).

• EWW's website (contains some Yuck syntax)
• Vim plugin for Yuck
• It seems like someone started to work on a parser, but deleted it

I don't know how to write TS grammars, so I'm unsure how much I can actually help here, but any work on this is appreciated!