fix(treesitter): drop select() kwargs #39646

Problem:
Unnecessary kwargs.

Solution:
Use param instead of kwargs.

runtime/doc/treesitter.txt

@@ -1056,10 +1056,9 @@ get_parser({buf}, {lang}, {opts})                *vim.treesitter.get_parser()*
     If no parser can be created, nil (and an error message) is returned.
 
     Parameters: ~
-      • {buf}   (`integer?`) Buffer the parser should be tied to (default:
-                current buffer)
-      • {lang}  (`string?`) Language of this parser (default: from buffer
-                filetype)
+      • {buf}   (`integer?`) (default: current buffer) Buffer the parser
+                should be tied to
+      • {lang}  (`string?`) (default: from 'filetype') Language of this parser
       • {opts}  (`table?`) Options to pass to the created language tree
 
     Return (multiple): ~
@@ -1160,16 +1159,15 @@ node_contains({node}, {range})                *vim.treesitter.node_contains()*
     Return: ~
         (`boolean`) True if the {node} contains the {range}
 
-select({target}, {opts})                             *vim.treesitter.select()*
+select({target}, {count})                            *vim.treesitter.select()*
     Starts or adjusts a |Visual| selection at cursor, based on tree nodes. The
     `target` parameter decides the selection behavior.
 
     Parameters: ~
       • {target}  (`'parent'|'child'|'next'|'prev'|'extend_next'|'extend_prev'`)
                   Decides the selection behavior.
-      • {opts}    (`table?`) A table with the following fields:
-                  • {count} (`integer?`, default: 1) Expand or adjust the
-                    selection this many times.
+      • {count}   (`integer?`) (default: 1) Expand or adjust the selection
+                  this many times.
 
 start({buf}, {lang})                                  *vim.treesitter.start()*
     Starts treesitter highlighting for a buffer
@@ -1193,17 +1191,16 @@ start({buf}, {lang})                                  *vim.treesitter.start()*
 <
 
     Parameters: ~
-      • {buf}   (`integer?`) Buffer to be highlighted (default: current
-                buffer)
-      • {lang}  (`string?`) Language of the parser (default: from buffer
-                filetype)
+      • {buf}   (`integer?`) (default: current buffer) Buffer to be
+                highlighted
+      • {lang}  (`string?`) (default: from 'filetype') Language of the parser
 
 stop({buf})                                            *vim.treesitter.stop()*
     Stops treesitter highlighting for a buffer
 
     Parameters: ~
-      • {buf}  (`integer?`) Buffer to stop highlighting (default: current
-               buffer)
+      • {buf}  (`integer?`) (default: current buffer) Buffer to stop
+               highlighting
 
 
 ==============================================================================

runtime/lua/vim/treesitter.lua

@@ -73,9 +73,9 @@ end
 ---
 --- If no parser can be created, nil (and an error message) is returned.
 ---
----@param buf (integer|nil) Buffer the parser should be tied to (default: current buffer)
----@param lang (string|nil) Language of this parser (default: from buffer filetype)
----@param opts (table|nil) Options to pass to the created language tree
+---@param buf integer|nil (default: current buffer) Buffer the parser should be tied to
+---@param lang string|nil (default: from 'filetype') Language of this parser
+---@param opts table|nil Options to pass to the created language tree
 ---
 ---@return vim.treesitter.LanguageTree? object to use for parsing
 ---@return string? error message, if applicable
@@ -336,7 +336,7 @@ end
 
 --- Returns a list of highlight capture names under the cursor
 ---
----@param win (integer|nil): |window-ID| or 0 for current window (default)
+---@param win integer|nil # |window-ID| or 0 for current window (default)
 ---
 ---@return string[] List of capture names
 function M.get_captures_at_cursor(win)
@@ -445,8 +445,8 @@ end
 --- })
 --- ```
 ---
----@param buf integer? Buffer to be highlighted (default: current buffer)
----@param lang string? Language of the parser (default: from buffer filetype)
+---@param buf integer? (default: current buffer) Buffer to be highlighted
+---@param lang string? (default: from 'filetype') Language of the parser
 function M.start(buf, lang)
   buf = vim._resolve_bufnr(buf)
   -- Ensure buffer is loaded. `:edit` over `bufload()` to show swapfile prompt.
@@ -463,7 +463,7 @@ end
 
 --- Stops treesitter highlighting for a buffer
 ---
----@param buf (integer|nil) Buffer to stop highlighting (default: current buffer)
+---@param buf integer|nil (default: current buffer) Buffer to stop highlighting
 function M.stop(buf)
   buf = vim._resolve_bufnr(buf)
 
@@ -512,26 +512,15 @@ function M.foldexpr(lnum)
   return M._fold.foldexpr(lnum)
 end
 
---- @class vim.treesitter.select.Opts
---- @inlinedoc
----
---- Expand or adjust the selection this many times.
---- (default: 1)
---- @field count integer?
-
 --- Starts or adjusts a |Visual| selection at cursor, based on tree nodes. The `target` parameter
 --- decides the selection behavior.
 ---
 ---@param target 'parent'|'child'|'next'|'prev'|'extend_next'|'extend_prev' Decides the selection behavior.
----@param opts vim.treesitter.select.Opts?
-function M.select(target, opts)
+---@param count? integer (default: 1) Expand or adjust the selection this many times.
+function M.select(target, count)
   vim.validate('target', target, 'string')
-  vim.validate('opts', opts, 'table', true)
-  opts = opts or {}
-  if opts.count then
-    vim.validate('count', opts.count, 'number')
-  end
-  local count = opts.count or 1
+  vim.validate('count', count, 'number', true)
+  count = count or 1
 
   if target == 'parent' then
     return M._select.select_parent(count)

test/functional/treesitter/select_spec.lua

@@ -41,7 +41,7 @@ local function treeselect(cmd_, count_)
   end
 
   exec_lua(function(cmd, count)
-    vim.treesitter.select(cmd, { count = count })
+    vim.treesitter.select(cmd, count)
   end, cmd_, count_)
 end