feat(treesitter): follow upstream captures

[ofseed]

nvim-treesitter may be updated soon, still in discussion but it is planned, see nvim-treesitter/nvim-treesitter#4799 (comment). The purpose is to follow the treesitter common core to share queries, so some captures will be redefined.

I created this PR to follow upstream changes to avoid highlights break by the breaking change.

There are some highlights defined in treesitter common core but not mentioned in nvim-treesitter

• @carriage-return
• @comment.documentation
• @embedded
• @escape
• @markup.link
• @markup.quote
• @property.builtin
• @variable.member

And not sure all helix captures will be applied. This PR only follow the common core, need to continue to follow the implementation.

[wookayin]

For the legacy highlights, instead of setting a separate highlight, highlight link would be a better idea.

[ofseed]

I think If the upstream does not do this, the downstream should not add it either, and for the legacy branch users, the highlights be linked to mean nothing because they should not exist yet.

For me recording a macro to assign again is simpler than linking them. :D

However, I will consider it carefully again before the PR gets merged.

[ofseed]

There are two extra highlight groups added:

• @markup.list, to reduce abuse of @punctuation.special
• @diff.delta, even not used in queries, I link it to diffChanged like the convention

One highlights group was split:

• @text.uri is now @markup.link.uri in markup links and @string.special.url outside of markup. I assigned the value of @text.uri to @markup.link.url.

[lucario387]

Updates here :)
@text.reference -> @markup.link and @field -> @variable.member, @markup.quote is now also added

Edit:
@comment.documentation is not mentioned because it's been supported for 6 to 8 months now 😄, so no need to convert/align with other consumers once again, when it's done in nvim-treesitter the same time as tree-sitter upstream.

[ofseed]

The refactor is merged into nvim-treesitter experimental branch main. I followed it up and it is ready to merge now.

[ofseed]

Some of the plugins I often use rely on the nvim-treesitter module system, so I cannot use this branch in daily use, it may need some review.

[lucario387]

nvim-treesitter/nvim-treesitter#5895 is the PR that will backport the changes to master. So you can test it there.

[ofseed]

LGTM.

[lucario387]

missing comment.todo. Also they should be @comment.*

[ofseed]

The former @text.todo has two different meanings,

• one for todo in comments, now @comment.warning
• one for todo lists, now @markup.list.checked/@markup.list.unchecked

So the comment.todo is a new capture, I think it's better not to add new highlights for now, especially since this highlight hasn't been utilized.(it's not exists in nvim-treesitter now)

[lucario387]

It is used though. text.todo in comments is replaced with comment.todo. As of now it's current a subset of the old text.todo, so it should get some highlighting

[ofseed]

Continue on #645

[nullchilly]

Thank you so much for the PR!