rneovim.git/runtime/lua/vim/treesitter.lua, branch userregs_2

feat(treesitter): allow disabling captures and patterns on TSQuery (#32790)

2025-03-11T13:45:01+00:00

Problem: Cannot disable individual captures and patterns in treesitter queries.

Solution: 
* Expose the corresponding tree-sitter API functions for `TSQuery` object. 
* Add documentation for `TSQuery`.
* Return the pattern ID from `get_captures_at_pos()` (and hence `:Inspect!`).

doc: clarify window-id, tab-id, nvim_set_current_x #32528

2025-02-27T10:05:00+00:00

Problem:
Descriptions are somewhat vague. nvim_set_current_line modifies contents
but nvim_set_current_buf does not, etc.

Solution:
- Make it clear that these functions accept or return a winid/tabid by
  linking to that concept in help.
- Only these few files use the term "handles", so replace them with the
  more conventional terminology.
- Add a new help section for tab-ID. This concept is unique to neovim
  because vim exposes tabnr, but not tab handles. This section is
  modelled after `:h winid`.

fix(treesitter)!: enforce buffer is loaded when creating parser

2025-02-19T18:11:55+00:00

Problem: `vim.treesitter._create_parser()` silently loads the buffer,
          bypassing the swapfile prompt.
Solution: Error for an unloaded buffer, ensure buffer is loaded in
          `vim.treesitter.start()` instead.

fix: resolve all remaining LuaLS diagnostics

2025-01-27T16:37:50+00:00

feat(treesitter)!: don't parse tree in get_parser() or start()

2025-01-12T16:10:49+00:00

**Problem:** `vim.treesitter.get_parser()` and `vim.treesitter.start()`
both parse the tree before returning it. This is problematic because if
this is a sync parse, it will stall the editor on large files. If it is
an async parse, the functions return stale trees.

**Solution:** Remove this parsing side effect and leave it to the user
to parse the returned trees, either synchronously or asynchronously.

feat(treesitter): async parsing

2025-01-12T16:10:47+00:00

**Problem:** Parsing can be slow for large files, and it is a blocking
operation which can be disruptive and annoying.

**Solution:** Provide a function for asynchronous parsing, which accepts
a callback to be run after parsing completes.

Co-authored-by: Lewis Russell 
Co-authored-by: Luuk van Baal 
Co-authored-by: VanaIgr

feat(treesitter): include capture id in return value of `get_captures_at_pos()` #30559

2024-12-11T12:34:24+00:00

**Problem:** Currently, it is difficult to get node(s)-level metadata
for a capture returned by `get_captures_at_pos()`. This is because it is
stored in `metadata[id]` and we do not have access to the value of `id`,
so to get this value we have to iterate over the keys of `metadata`. See
[this commit](https://github.com/neovim/neovim/commit/d63622930001b39b12f14112fc3abb55b760c447#diff-8bd4742121c2f359d0345f3c6c253a58220f1a28670cc4e1c957992232059a6cR16).

Things would be much simpler if we were given the `id` of the capture so
we could use it to just index `metadata` directly.

**Solution:** Include `id` in the data returned by
`get_captures_at_pos()`

refactor: add vim._resolve_bufnr

2024-12-07T16:58:40+00:00

fix: another round of type annotation fixes

2024-10-31T11:55:23+00:00

feat(vim.validate): improve fast form and deprecate spec form

2024-10-21T10:32:06+00:00

Problem:

`vim.validate()` takes two forms when it only needs one.

Solution:

- Teach the fast form all the features of the spec form.
- Deprecate the spec form.
- General optimizations for both forms.
- Add a `message` argument which can be used alongside or in place
  of the `optional` argument.