feat(treesitter)!: use new standard captures

[clason]

Problem: Sharing queries with upstream tree-sitter and Helix is difficult. Also, queries look funky.

Solution: Use treesitter standard captures and Helix (Sublime-style) captures where reasonable. Document them to make them official. Also, format queries with formatting tool. Sync queries with nvim-treesitter.

This essentially defines a full set of canonical capture names and is a step toward declaring treesitter highlighting as stable. (It also effectively transfers ownership of the "canonical list" to Neovim core.)

See nvim-treesitter/nvim-treesitter#5831

@echasnovski I defined all treesitter highlight groups from the "standard set" by linking to default captures (unless the standard fallback looked reasonable); I expect you'll fine tune this based on the default colorscheme. Nevertheless, if you notice a group where a different link would be better, let me know.

[clason]

Note

[gpanders]

Changing capture names will break user defined queries so this should be marked as a breaking change.

[echasnovski]

This is a monumental improvement in terms of usability, I should say. Seeing updated documentation with actual descriptions of what group is supposed to do warms my color scheme author heart.

Sorry for a lot of comments. None of them is blocking (aside from @module, I'd say) and can be resolved in my (planned) follow up for default color scheme.

[clason]

These changes are now live on nvim-treesitter, so marking as ready for review.

[MariaSolOs]

IDK how clear we were about this before, but what this makes me think as a vanilla Neovim user that has no advanced context/knowledge of these changes is: "Ok I don't need to worry about @tag in my color theme bc I don't use XML at all", yet a seemingly unrelated language like yuck uses it in its queries.

Maybe it would be worth it to document such a gotcha here?

[lucario387]

Shouldn't that be on yuck query maintainers to document that :? 🤔 I tried a

(button :onclick "notify-send Left"
  :onrightclick "notify-send Right"
  "Click Me!") ;; this is a label nested within a button

Where button is the symbol, and the syntax have some similarities to XML

[MariaSolOs]

Fair point, but I'm bringing this up from the perspective of a Neovim user that's updating their TS queries to satisfy their colorful desires: If I find a query that at first glance look language/file extension exclusive, I might forget to consider which other languages might be affected.

I highlight these capture groups in particular because XML is included in the name, instead of an example as in previous groups.

[clason]

That's fine, feel free to suggest a better description. (I don't do weebdev.)

[ObserverOfTime]

We can clean up improperly used @tag highlights in nvim-treesitter later (probably should have handled it in my consistency PR tbh), but yuck (and other?) widgets are similar to XML tags and can maybe also use it.

Update: nvim-treesitter/nvim-treesitter#5942

[clason]

Hmm, not sure I agree with this anymore -- I inherited from the old links, but it seems wrong. Special seems much better (and making the other three derive from raw).

@echasnovski ?

[echasnovski]

If this is about only @markup.environment, then I don't have any particular opinion on this one. Judging purely by the meaning, I'd say that it should link to @module.
Making other link to @markup.raw is reasonable.

[clason]

...and @module links to Structure ;)