From 838f130e6a0b018853c63e7908f98e53a2b7fa7e Mon Sep 17 00:00:00 2001
From: "Justin M. Keyes" <justinkz@gmail.com>
Date: Tue, 4 Aug 2026 20:00:51 +0200
Subject: [PATCH] fix(types): emmylua warning about `params` field

---
 src/gen/gen_eval_files.lua | 10 +++++-----
 src/nvim/eval.lua          |  2 +-
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/gen/gen_eval_files.lua b/src/gen/gen_eval_files.lua
index 22f59e8425..89b13660da 100755
--- a/src/gen/gen_eval_files.lua
+++ b/src/gen/gen_eval_files.lua
@@ -98,7 +98,7 @@ local function split(x, sep)
 end
 
 --- @param f string
---- @param params [string,string][]|true
+--- @param params [string,string,string?][]|true
 --- @return string
 local function render_fun_sig(f, params)
   local param_str --- @type string
@@ -107,7 +107,7 @@ local function render_fun_sig(f, params)
   else
     param_str = table.concat(
       vim.tbl_map(
-        --- @param v [string,string]
+        --- @param v [string,string,string?]
         --- @return string
         function(v)
           return luaescape(v[1])
@@ -126,8 +126,8 @@ local function render_fun_sig(f, params)
 end
 
 --- Uniquify names
---- @param params [string,string,string][]
---- @return [string,string,string][]
+--- @param params [string,string,string?][]
+--- @return [string,string,string?][]
 local function process_params(params)
   local seen = {} --- @type table<string,true>
   local sfx = 1
@@ -192,7 +192,7 @@ local function get_api_meta()
       sees[#sees + 1] = see.desc
     end
 
-    local params = {} --- @type [string,string][]
+    local params = {} --- @type [string,string,string?][]
     for _, p in ipairs(fun.params) do
       params[#params + 1] = {
         p.name,
diff --git a/src/nvim/eval.lua b/src/nvim/eval.lua
index 0321db3384..8834682e52 100644
--- a/src/nvim/eval.lua
+++ b/src/nvim/eval.lua
@@ -14,7 +14,7 @@
 --- @field generics? string[] Used to write `---@generic` annotations over a function.
 --- @field signature? string
 --- @field desc? string
---- @field params [string, string, string][]
+--- @field params [string, string, string?][] Each entry is `{name, type, desc?}`; `desc` is only present in API-meta entries.
 --- @field notes? string[]
 --- @field see? string[]
 ---