chore(luals): more config typings

fzf-lua.config.Base

inherit config.Base

generated from vim macro

fix config.Git

config.BufferLines

opts.{_bufnr,_bufname} -> local var

fix luals

dedup

file_icons

color_icons

_types

multiprocess

git_icons

fzf_colors

dedup

continue dedup

d winopts

d _actions

d fzf_opts

cwd_prompt

silent

line_query is files opts

cached_hls?

previewer

actions can be false

fix: changes extends jumps

opts.preview

opts.mark

opts.complete

luals fixes

git pickers

set headers

colorschems

opts._cur..

remove useless options

opts._packpath

opts._live

daps

opts._frames

opts._cfgs

diagnosics

opts.__signs

ui_select

grep

helptags

tmux

meta

oldfile

tags

lsp

api

rename

unsilent deprecated

Author: phanen

lua/fzf-lua/complete.lua

@@ -79,6 +79,7 @@ local set_cmp_opts_path = function(opts)
 end
 
 M.path = function(opts)
+  ---@type fzf-lua.config.CompletePath
   opts = config.normalize_opts(opts, "complete_path")
   if not opts then return end
   opts.cmd = opts.cmd or (function()
@@ -97,9 +98,9 @@ M.path = function(opts)
 end
 
 M.file = function(opts)
+  ---@type fzf-lua.config.CompleteFile
   opts = config.normalize_opts(opts, "complete_file")
   if not opts then return end
-  opts.cmp_is_file = true
   opts.cmd = opts.cmd or (function()
     if vim.fn.executable("fdfind") == 1 then
       return "fdfind --strip-cwd-prefix --type f --exclude .git"
@@ -118,6 +119,7 @@ M.file = function(opts)
 end
 
 M.line = function(opts)
+  ---@type fzf-lua.config.CompleteLine
   opts = config.normalize_opts(opts, "complete_line")
   if not opts then return end
   opts.query = (function()
@@ -133,6 +135,7 @@ M.line = function(opts)
 end
 
 M.bline = function(opts)
+  ---@type fzf-lua.config.CompleteBline
   opts = opts or {}
   opts.current_buffer_only = true
   return M.line(opts)

lua/fzf-lua/config.lua

@@ -142,7 +142,7 @@ local eval = function(v, ...)
   return v
 end
 
----@param opts table<string, unknown>|fun():table?
+---@param opts fzf-lua.config.Base|{}|fun():table?
 ---@param globals string|table?
 ---@param __resume_key string?
 ---@return fzf-lua.Config?
@@ -272,10 +272,7 @@ function M.normalize_opts(opts, globals, __resume_key)
   -- Backward compat: merge `winopts` with outputs from `winopts_fn`
   local winopts_fn = opts.winopts_fn or M.globals.winopts_fn
   if type(winopts_fn) == "function" then
-    if not opts.silent then
-      utils.warn(
-        "Deprecated option: 'winopts_fn' -> 'winopts'. Add 'silent=true' to hide this message.")
-    end
+    vim.deprecate("winopts_fn", "winopts", "Jan 2026", "FzfLua")
     local ret = winopts_fn(opts) or {}
     if not utils.tbl_isempty(ret) and (not opts.winopts or type(opts.winopts) == "table") then
       opts.winopts = vim.tbl_deep_extend("force", opts.winopts or {}, ret)
@@ -445,11 +442,7 @@ function M.normalize_opts(opts, globals, __resume_key)
         utils.map_set(opts, new_key, old_val)
       end
       utils.map_set(opts, old_key, nil)
-      if not opts.silent then
-        utils.warn(string.format(
-          "Deprecated option: '%s' -> '%s'. Add 'silent=true' to hide this message.",
-          old_key, new_key))
-      end
+      vim.deprecate(old_key, new_key, "Jan 2026", "FzfLua")
     end
   end
 

lua/fzf-lua/core.lua

@@ -142,7 +142,7 @@ end
 -- Main API, see:
 -- https://github.com/ibhagwan/fzf-lua/wiki/Advanced
 ---@param contents content
----@param opts? {fn_transform: function}
+---@param opts? fzf-lua.config.Base|{}
 ---@return thread?, string?, table?
 M.fzf_exec = function(contents, opts)
   opts = config.normalize_opts(opts or {}, {})
@@ -158,7 +158,7 @@ M.fzf_exec = function(contents, opts)
   -- command is independent, most of it's options are serialized as strings and the
   -- rest are read from the main instance config over RPC
   local mt = (opts.multiprocess and type(contents) == "string")
-  local cmd = mt and shell.stringify_mt(contents, opts)
+  local cmd = mt and shell.stringify_mt(contents --[[@as string]], opts)
       or shell.stringify(contents, opts, nil)
   -- Contents sent to fzf can only be nil or a shell command (string)
   -- the API accepts both tables and functions which we "stringify"

lua/fzf-lua/defaults.lua

@@ -39,6 +39,9 @@ function M._man_cmd_fn(bat_pager)
   return string.format("%s %%s 2>/dev/null | %s", cmd, pager)
 end
 
+---missing fields are injected later, not sure how to tell luals about it
+---@diagnostic disable: missing-fields
+---@type fzf-lua.config.Defaults
 M.defaults                      = {
   nbsp          = utils.nbsp,
   winopts       = {
@@ -360,6 +363,7 @@ M.defaults.files                = {
   winopts                = { preview = { winopts = { cursorline = false } } },
 }
 
+---@diagnostic disable-next-line: assign-type-mismatch
 M.defaults.global               = vim.tbl_deep_extend("force", M.defaults.files, {
   silent            = true,
   -- TODO: lsp_workspace_symbols locate, not working yet
@@ -596,6 +600,7 @@ M.defaults.grep                 = {
   _treesitter    = true,
 }
 
+---@diagnostic disable-next-line: assign-type-mismatch
 M.defaults.grep_curbuf          = vim.tbl_deep_extend("force", M.defaults.grep, {
   rg_glob          = false, -- meaningless for single file rg
   exec_empty_query = true,  -- makes sense to display lines immediately
@@ -764,6 +769,7 @@ M.defaults.lines                = {
   _ctx             = { includeBuflist = true },
 }
 
+---@diagnostic disable-next-line: assign-type-mismatch
 M.defaults.blines               = vim.tbl_deep_extend("force", M.defaults.lines, {
   show_bufname    = false,
   show_unloaded   = true,
@@ -1126,8 +1132,10 @@ M.defaults.marks                = {
 }
 
 M.defaults.changes              = {
-  cmd = "changes",
-  h1 = "change",
+  cmd       = "changes",
+  h1        = "change",
+  actions   = { ["enter"] = actions.goto_jump },
+  previewer = { _ctor = previewers.builtin.jumps },
 }
 
 M.defaults.jumps                = {