hoge

Author: delphinus

lua/plenary/test_harness.lua

@@ -9,8 +9,10 @@ local headless = require("plenary.nvim_meta").is_headless
 
 local plenary_dir = vim.fn.fnamemodify(debug.getinfo(1).source:match "@?(.*[/\\])", ":p:h:h:h")
 
+---@class PlenaryTestHarness
 local harness = {}
 
+---@type fun(_, ...)
 local print_output = vim.schedule_wrap(function(_, ...)
   for _, v in ipairs { ... } do
     io.stdout:write(tostring(v))
@@ -20,7 +22,11 @@ local print_output = vim.schedule_wrap(function(_, ...)
   vim.cmd [[mode]]
 end)
 
+---@param job_id integer
+---@return fun(bufnr: integer, ...: string)
 local get_nvim_output = function(job_id)
+  ---@param bufnr integer
+  ---@param ... string
   return vim.schedule_wrap(function(bufnr, ...)
     if not vim.api.nvim_buf_is_valid(bufnr) then
       return
@@ -31,6 +37,8 @@ local get_nvim_output = function(job_id)
   end)
 end
 
+---@param command string
+---@return nil
 function harness.test_directory_command(command)
   local split_string = vim.split(command, " ")
   local directory = vim.fn.expand(table.remove(split_string, 1))
@@ -40,6 +48,19 @@ function harness.test_directory_command(command)
   return harness.test_directory(directory, opts)
 end
 
+---@class PlenaryTestHarnessOptions
+---@field init? string
+---@field keep_going? boolean
+---@field minimal? boolean
+---@field minimal_init? string
+---@field nvim_cmd? string
+---@field sequential? boolean
+---@field timeout? integer
+---@field winopts? PlenaryWindowFloatOptions
+
+---@param paths string[]
+---@param opts? PlenaryTestHarnessOptions
+---@return nil
 local function test_paths(paths, opts)
   local minimal = not opts or not opts.init or opts.minimal or opts.minimal_init
 
@@ -53,6 +74,7 @@ local function test_paths(paths, opts)
 
   vim.env.PLENARY_TEST_TIMEOUT = opts.timeout
 
+  ---@type { bufnr: integer, win_id: integer, border_bufnr: integer, border_win_id: integer, job_id: integer }
   local res = {}
   if not headless then
     res = win_float.percentage_range_window(0.95, 0.70, opts.winopts)

lua/plenary/window/float.lua

@@ -154,7 +154,7 @@ end
 ---@param row_range integer
 ---@param win_opts? PlenaryWindowFloatOptions
 ---@param border_opts? PlenaryWindowBorderBorderOptions
----@return table
+---@return { bufnr: integer, win_id: integer, border_bufnr: integer, border_win_id: integer }
 function win_float.percentage_range_window(col_range, row_range, win_opts, border_opts)
   win_opts = tbl.apply_defaults(win_opts, win_float.default_options)