nvim-treesitter/CONTRIBUTING.md, branch feat/stable

docs(contributing): inclusion criteria

2026-01-18T16:31:30Z

feat(parsers)!: remove gitlab-hosted blueprint, fusion, jsonc

2025-12-06T17:10:39Z

Problem: Gitlab has too frequent outages, which break automation. Solution: Drop all Gitlab-hosted parsers (two of which have been unmaintained for years).

chore: remove format-queries script

2025-11-14T21:58:12Z

The source of truth for formatting (according to make formatquery and CI) is now ts_query_ls, so remove the no longer required script to prevent divergence and bitrotting.

feat(install): remove node requirement

2025-10-30T07:36:00Z

* supported parsers _must_ commit at least `grammar.json` * set `TREE_SITTER_JS_RUNTIME=native` when generating parser to use built-in quickjs instead of node (requires tree-sitter 0.26)

docs: specify fold dos and don'ts

2025-07-15T08:53:32Z

docs: final update after rewrite

2025-05-21T07:15:29Z

Make clear this is not the default branch

docs: update to rewrite

2025-05-12T16:43:41Z

This updates * README * CONTRIBUTING * the `:h nvim-treesitter` documentation to the current state of `main`. It also adds a pull request template for adding a new language.

feat!: update tier 1 parsers to versions

2025-05-12T16:43:41Z

feat(locals)!: remove locals module

2025-05-12T16:43:41Z

Problem: `locals.lua` was neither used nor tested, and providing it goes against the goal of nvim-treesitter not being a required dependency for other plugins. Solution: Remove the module and document that the queries are provided as-is for limited backward compatibility only.

feat: add .tsqueryrc.json

2025-05-12T16:43:40Z

feat(parsers): rework tiers

2025-05-12T16:43:40Z

* stable: updates follow semver releases (todo) * unstable: updates follow HEAD (default) * unmaintained: no automatic updates * unsupported: no updates, cannot be installed

feat!: track parser revision in Lua

2025-05-12T16:43:40Z

Problem: Tracking parser revision in lockfile and allowing override through the parsers module complicates the code. In addition, only revision changes are handled robustly, not changes to other installation info. Solution: Track parser revision in the parsers module directly. Reload parser table on every install or update call. Support modifying parser table in a `User TSUpdate` autocommand.

feat(install)!: generate from json instead of requiring node

2025-05-12T16:43:40Z

Problem: Many parsers require node/npm to evaluate the `grammar.js` before being able to generate a parser from it. Solution: Generate from `grammar.json` instead, which is fully resolved. Drops `node` and `npm` as (optional) requirements for nvim-treesitter. Note that this requires parsers to commit the generated json iff the grammar requires evaluation (which is currently the case for all tracked languages).

feat(install)!: remove support for C++ scanners

2025-05-12T16:43:40Z

doc: better clarification of highlights/injections

2025-05-12T16:43:40Z

docs: update CONTRIBUTING.md

2025-05-12T16:43:40Z

feat!: drop modules, general refactor and cleanup

2025-05-12T16:43:40Z

refactor(queries): Remove quotes from properties in set! directive

2024-07-28T09:43:41Z

feat: standardize and document export keywords

2024-05-13T07:16:31Z

Many export keywords are captured as `@keyword.import`. This commit makes it so they are all captured like that, and mentions it in the documentation.

feat: more `@keyword.type` captures

2024-05-01T07:59:50Z

feat(rust,lalrpop): `@attribute` for lifetimes

2024-03-16T12:51:16Z

`@keyword` is only for language-defined keywords.

feat(highlights)!: remove non-keyword `@type.qualifier`

2024-03-16T12:51:16Z

* blueprint: Don't specially highlight template_name_qualifier. This is similar to inheritance base class. Other languages don't highlight them specially. * eds: `@type` for all `*Type` keys * chatito: `@attribute` for variation

feat(highlights)!: `@keyword.storage` → `@keyword.modifier`

2024-03-16T12:51:16Z

feat(highlights)!: keyword `@type.qualifier` → `@keyword.modifier`

2024-03-16T12:51:16Z

fix(comment): remove duplicate 'FIXME'

2024-03-03T15:03:26Z

feat(highlights)!: enforce documented captures (#6232)

2024-03-03T10:00:11Z

Problem: Allowing undocumented "secret" (sub)captures makes it harder to write comprehensive colorschemes and catch inconsistent captures. Solution: Only allow captures listed in CONTRIBUTING.md. Add useful (cross-language) subcaptures and drop language-specific or too niche ones. Follow-up: Adding further `*.builtin` captures and changing queries to use them. Language-specific subcaptures should instead be added in user config or a custom language plugin.

docs(contributing): typos and examples

2024-01-21T11:04:42Z

fix(comments)!: consolidate note captures

2024-01-20T16:52:50Z

Distinguishing `hint` and `info` is too confusing; it's enough to have `error`, `warning`, `todo`, and `note`.

docs: update CONTRIBUTING.md with formatting

2024-01-19T15:58:37Z

feat!: align standard captures with upstream

2024-01-19T15:58:37Z

Problem: Sharing highlight queries with upstream tree-sitter and Helix is difficult. Solution: Where reasonable, use capture names in tree-sitter's standard list or Helix's Atom-style hierarchy. Specifically: * tree-sitter "standard capture names" (https://github.com/tree-sitter/tree-sitter/blob/3f44b896852eb7daaa6df4fb778c9bb52c70c815/highlight/src/lib.rs#L20-L72): - `@parameter` -> `@variable.parameter` - `@field` -> `@variable.member` - `@namespace` -> `@module` - `@float` -> `@number.float` - `@symbol` -> `@string.special.symbol` - `@string.regex` -> `@string.regexp` - `@text.*` -> `@markup.*` (`strong`, `italic`, `link`, `strikethrough`; with exceptions; see below) - `@text.title` -> `@markup.heading` - `@text.literal` -> `@markup.raw` - `@text.reference` -> `@markup.link` - `@text.uri` -> `@markup.link.url` (in markup links) - `@string.special` -> `@markup.link.label` (non-url links) - `@punctuation.special` -> `@markup.list` (markdown lists only; move subitems from `@text.todo`) * Helix captures (https://docs.helix-editor.com/master/themes.html#syntax-highlighting): - `@method` -> `@function.method` - `@method.call` -> `@function.method.call` - `@text.{todo,warning,note,danger}` -> `@comment.{error,warning,hint,info,todo}` - `@text.diff.{add,delete,}` -> `@diff.{plus,minus,delta}` - `@text.uri` -> `@string.special.url` (outside markup) - `@preproc` -> `@keyword.directive` - `@define` -> `@keyword.directive`(`.define`?) - `@storageclass` -> `@keyword.storage` - `@conditional` -> `@keyword.conditional` - `@debug` -> `@keyword.debug` - `@exception` -> `@keyword.exception` - `@include` -> `@keyword.import` - `@repeat` -> `@keyword.repeat` * cleanup - remove some redundant `@conceal` (but still allow it for conceal-only patterns) - remove obsolete `@error` (syntax linting is out of scope for this repo) - sort, cleanup capture list in `CONTRIBUTING.md`

feat(locals)!: switch to upstream captures

2024-01-19T15:58:37Z

docs: improve description of `@type.definition` capture

2023-10-20T19:59:56Z

Co-authored-by: ObserverOfTime

chore(injections)!: update injection syntax to 0.9

2023-08-12T15:34:15Z

Since 0.9, @lang syntax is still available as fallback but will soon be deprecated. Because of that, new syntax should be adopted once 0.9 becomes the baseline requirements for nvim-treesitter - update health check - update doc

fix(spell): do not spell check certain types of strings (#5203)

2023-08-07T12:42:24Z

- Document that only certain kinds of strings are spell checked, and reasons why they may not. - Remove spell checking for bash strings.

fix(highlights): lower priority for codeblocks with injections (#4905)

2023-06-05T12:09:44Z

docs: add a small note about local queries

2023-04-03T08:54:02Z

This just adds a small note in the CONTRIBUTING section about local queries and how they differ from those listed upstream.

use indent.X syntax for captures and properties of set directives

2023-03-24T17:07:53Z

update CONTRIBUTING.md adjust indents for bass fix doc capture comment

docs: add `@comment.documentation`

2023-03-05T22:15:32Z

docs: add `@string.documentation`

2023-03-05T22:15:32Z

docs: add `@keyword.coroutine`

2023-03-03T15:07:52Z

Update CONTRIBUTING.md

2023-02-18T08:16:30Z

Fixed link of the supported languages.

prettier formatting yml and md

2023-02-16T09:48:37Z

docs: fix comment alignment

2023-01-21T12:37:07Z

docs: swap life-time around

2023-01-15T09:58:02Z

Co-authored-by: ObserverOfTime

docs: clarify @storageclass in CONTRIBUTING docs

2023-01-15T09:58:02Z

This is just a tiny change that was in reference to https://github.com/nvim-treesitter/nvim-treesitter/pull/4153#discussion_r1070276800. The basis is that `@storageclass` should only be used unless it's actually affecting storage in memory. There are further conversations about this in the following places: - https://github.com/nvim-treesitter/nvim-treesitter/pull/3648#issuecomment-1279923861 - https://github.com/nvim-treesitter/nvim-treesitter/pull/3648#issuecomment-1291624844

markdown: add strikethrough and blockquote captures

2023-01-14T10:52:25Z

docs: remove remaining references to Zulip

2023-01-11T20:17:08Z

highlights: create subscoping for ternary operator

2022-12-02T20:42:11Z

After https://github.com/nvim-treesitter/nvim-treesitter/issues/470, we decided to use `@conditional` for ternary operator instead of operator despite `@conditional` is documented for keywords only. A sub-scoping can make it easier for people to highlight this operator group differently. Also unify the usage of `@conditional...` across languages.

docs: fix contributing guidelines

2022-11-26T11:17:51Z

docs: add `@nospell` to contributing.md

2022-11-19T15:31:38Z

supported as of Neovim v0.8.1

rust: use @type.qualifier and @storageclass

2022-11-06T17:10:42Z

feat(diff): add diff parser

2022-10-19T23:22:58Z

This commit introduce diff parser.

docs: document all the captures in CONTRIBUTING.md

2022-10-17T10:12:34Z

Update CONTRIBUTING.md

2022-09-10T18:07:45Z

Add `@variable.globle` to available variable captures.

feat(spell): upstream spell queries from spellsitter

2022-09-06T11:44:19Z

Updated CONTRIBUING.md

2022-08-03T19:05:30Z

Add capture groups for remaining builtin highlight groups

2022-03-30T20:14:23Z

Some builtin highlight groups (see `:h group-name`) do not yet have associated capture groups, so add them.

Zulip link was missing protocol portion?

2022-03-30T14:02:38Z

highlights: conceal `"` in JSON

2022-03-26T17:36:49Z

Fixes #645

docs: add `@zero_indent` to CONTRIBUTING.md

2022-02-05T17:54:55Z

update TLA+ revision, add queries for PlusCal (#2344)

2022-01-25T21:02:20Z

feat(indent): ecma - support try_catch and if_else

2022-01-21T15:40:36Z

feat(indent): support `@aligned_indent` for python

2022-01-21T09:51:51Z

feat: rewrite indent module

2022-01-21T09:51:51Z

docs(CONTRIBUTING.md): mention Neovim's tree-sitter Matrix channel (#2294)

2022-01-19T11:57:55Z

As suggested here: https://github.com/nvim-treesitter/nvim-treesitter/pull/2288#issuecomment-1015163267

docs: refresh CONTRIBUTING.md

2022-01-18T08:22:10Z

- Mention Zulip instead of Gitter - Use query filetype instead of scheme

Update queries

2021-12-22T20:17:28Z

- Don't use the old form for predicates - Update some invalid queries

Fix misleading text in `CONTRIBUTING.md` (#2137)

2021-12-18T18:07:18Z

chore: fix typos

2021-11-02T22:47:48Z

Typo fix and reword doc

2021-09-08T00:21:39Z

add keywords to scala highlights (#1662)

2021-08-25T23:38:45Z

* add keywords to scala highlights * special capture for special keywords * add while to 'repeat' capture * pr cleanup, exmaples in CONTRIBUTING.md * add backquotes for consistency in docs * group @repeat keywords, fix null * comment-out 'macro' and 'forSome' * fix 'this' and 'super' keyword * remove accidental files :facepalm: * update revision * fix "super" and "this" * godammit these .metals files are killing me * why did I commit this??? Co-authored-by: Stuart Mashaal

add @tag.attribute for html like attributes

2021-07-14T08:13:13Z

Use stylua for autoformat code (#1480)

2021-07-04T21:12:17Z

feat(keywords) merge return and yield into keyword.return group

2021-07-04T19:49:17Z

feat(keywords) add keyword.return & keyword.yield

2021-07-04T19:49:17Z

Improve check-queries (#1253)

2021-05-31T17:03:27Z

- Add checks for injections. - Allow queries that start with [A-Z] for highlights only. - Don't stop on the first error, finish checking all queries.

Add text.reference and text.environment

2021-03-30T17:26:37Z

latex: add TSMath that behaves like vimtex math highlighting

2021-03-30T17:26:37Z

Add comment parser to highlight comment tags (#893)

2021-03-12T16:21:46Z

Closes #236

[highlights] Add TSSymbol highlight group

2021-03-04T05:19:40Z

Addresses issue #892 Ruby and Dart literal symbols will now be highlighted by the new TSSymbol highlight group, which itself will, by default, link to the Vim Identifier highlight group. Vim theme authors can then set their TSSymbol colors. Symbol highlighting can apply to a number of languages as noted in the following Wikipedia page: https://en.wikipedia.org/wiki/Symbol_(programming) Not just for Ruby and Dart.

HTML: improve highlights & injections

2021-02-11T06:42:19Z

Remove usages of `@embedded` in highlights

2021-01-06T14:12:32Z

Python highlights: Add regex injections: re.match(r"...")

2021-01-03T18:05:38Z

Regex highlights: Add constant highlight for class_character

2021-01-03T18:05:38Z

Remove textobjects from contributing

2020-10-23T10:41:50Z

feat(queries): modeline mechanism for base langs

2020-10-11T17:09:22Z

This implements https://github.com/neovim/neovim/pull/13059#issuecomment-704414189 This behaves like modelines and remove the use of the base_language map. Also, this allows to fine-tune what we actually want to include per query, which is better IMO.

fix(highlights): Add TSNamespace highlight

2020-10-10T13:31:51Z

Start adding highlights for - C++ - Rust (including other scoped_identifier/scoped_type_identifier fixes) - JS (only namespace_import) Addresses #516

Add @keyword.operator for operators that are English words and add @exception for Java/JS

2020-09-19T05:30:49Z

Add TSTag and TSTagDelimiter groups

2020-09-18T15:09:43Z

These groups will be added for use with xml-like tags such as html and jsx.

Update CONTRIBUTING.md

2020-09-17T15:21:29Z

Co-authored-by: Thomas Vigouroux

Update contributing

2020-09-17T15:21:29Z

Remove @definition.doc captures

2020-09-17T07:18:05Z

These aren't really definitions and are being show in the definitions list. We aren't using them at the moment, we could use another group or query file.

add @none to contributing.md

2020-09-14T22:19:04Z

Folds: rename query files to folds.scm to be consistent

2020-09-14T16:26:30Z

We use plural names for all query files except folds.

ci: check capture names in queries

2020-09-11T10:02:35Z

docs(fold): document and comment

2020-09-01T19:51:17Z

Docs: document `@punctuation.special`

2020-08-16T18:36:32Z

Merge pull request #296 from steelsojka/feat-is-predicate

2020-08-16T16:27:15Z

feat(highlights): add is predicate

feat(definitions): allow setting of scope

2020-08-16T14:10:09Z

feat(highlights): add is predicate

2020-08-16T14:04:07Z