feat: add type annotations for plenary.tbl

Author: delphinus

lua/plenary/init.lua

@@ -4,6 +4,7 @@
 ---@field functional PlenaryFunctional
 ---@field path PlenaryPath
 ---@field scandir PlenaryScandir
+---@field tbl PlenaryTbl
 local plenary = setmetatable({}, {
   __index = function(t, k)
     local ok, val = pcall(require, string.format("plenary.%s", k))

lua/plenary/tbl.lua

@@ -1,5 +1,10 @@
+---@class PlenaryTbl
 local tbl = {}
 
+---@generic T, U
+---@param original table<T, U>
+---@param defaults table<T, U>
+---@return table<T, U>
 function tbl.apply_defaults(original, defaults)
   if original == nil then
     original = {}
@@ -16,10 +21,16 @@ function tbl.apply_defaults(original, defaults)
   return original
 end
 
+---@param ... any
+---@return table
 function tbl.pack(...)
   return { n = select("#", ...), ... }
 end
 
+---@param t table
+---@param i? integer
+---@param j? integer
+---@return ...
 function tbl.unpack(t, i, j)
   return unpack(t, i or 1, j or t.n or #t)
 end