feat(commands): added highlight groups (closes #2357)

Use `FzfLuaCmdEx|FzfLuaCmdBuf|FzfLuaCmdGlobal` to customize.

Author: ibhagwan

OPTIONS.md

@@ -677,6 +677,24 @@ Type: `string`, Default: `FzfLuaLiveSym`
 
 Highlight group for the matched characters in `lsp_live_workspace_symbols`.
 
+#### globals.hls.cmd_global
+
+Type: `string`, Default: `FzfLuaCmdGlobal`
+
+Highlight group for global commands in `:FzfLua commands`, by default links to `Directory`.
+
+#### globals.hls.cmd_buf
+
+Type: `string`, Default: `FzfLuaCmdBuf`
+
+Highlight group for buffer commands in `:FzfLua commands`, by default links to `Added`.
+
+#### globals.hls.cmd_ex
+
+Type: `string`, Default: `FzfLuaCmdEx`
+
+Highlight group for ex commands in `:FzfLua commands`, by default links to `Statement`.
+
 #### globals.hls.fzf.normal
 
 Type: `string`, Default: `FzfLuaFzfNormal`

README.md

@@ -1619,6 +1619,9 @@ temporarily overridden by its corresponding `winopts` option:
 | FzfLuaFilePart          | @none            | `hls.file_part`      | Path formatters file hl group         |
 | FzfLuaLivePrompt        | \*PaleVioletRed1 | `hls.live_prompt`    | "live" queries prompt text            |
 | FzfLuaLiveSym           | \*PaleVioletRed1 | `hls.live_sym`       | LSP live symbols query match          |
+| FzfLuaCmdEx             | Statement        | `hls.cmd_ex`         | Ex commands in `commands`             |
+| FzfLuaCmdBuf            | Added            | `hls.cmd_buf`        | Buffer commands in `commands`         |
+| FzfLuaCmdGlobal         | Directory        | `hls.cmd_global`     | Global commands in `commands`         |
 | FzfLuaFzfNormal         | FzfLuaNormal     | `fzf.normal`         | fzf's `fg\|bg`                        |
 | FzfLuaFzfCursorLine     | FzfLuaCursorLine | `fzf.cursorline`     | fzf's `fg+\|bg+`                      |
 | FzfLuaFzfMatch          | Special          | `fzf.match`          | fzf's `hl+`                           |

doc/fzf-lua-opts.txt

@@ -1,4 +1,4 @@
-*fzf-lua-opts.txt*        For Neovim >= 0.8.0        Last change: 2025 June 28
+*fzf-lua-opts.txt*      For Neovim >= 0.8.0     Last change: 2025 September 22
 
 ==============================================================================
 Table of Contents                             *fzf-lua-opts-table-of-contents*
@@ -905,6 +905,33 @@ Highlight group for the matched characters in `lsp_live_workspace_symbols`.
 
 
 
+globals.hls.cmd_global                   *fzf-lua-opts-globals.hls.cmd_global*
+
+Type: `string`, Default: `FzfLuaCmdGlobal`
+
+Highlight group for global commands in `:FzfLua commands`, by default links to
+`Directory`.
+
+
+                                                                              
+globals.hls.cmd_buf                         *fzf-lua-opts-globals.hls.cmd_buf*
+
+Type: `string`, Default: `FzfLuaCmdBuf`
+
+Highlight group for buffer commands in `:FzfLua commands`, by default links to
+`Added`.
+
+
+                                                                              
+globals.hls.cmd_ex                           *fzf-lua-opts-globals.hls.cmd_ex*
+
+Type: `string`, Default: `FzfLuaCmdEx`
+
+Highlight group for ex commands in `:FzfLua commands`, by default links to
+`Statement`.
+
+
+                                                                              
 globals.hls.fzf.normal                   *fzf-lua-opts-globals.hls.fzf.normal*
 
 Type: `string`, Default: `FzfLuaFzfNormal`

lua/fzf-lua/defaults.lua

@@ -1231,6 +1231,7 @@ M.defaults.commands              = {
   actions         = { ["enter"] = actions.ex_run },
   flatten         = {},
   include_builtin = true,
+  _cached_hls     = { "cmd_ex", "cmd_buf", "cmd_global" },
 }
 
 M.defaults.autocmds              = {
@@ -1456,6 +1457,9 @@ M.defaults.__HLS                 = {
   file_part      = "FzfLuaFilePart",
   live_prompt    = "FzfLuaLivePrompt",
   live_sym       = "FzfLuaLiveSym",
+  cmd_ex         = "FzfLuaCmdEx",
+  cmd_buf        = "FzfLuaCmdBuf",
+  cmd_global     = "FzfLuaCmdGlobal",
   fzf            = {
     normal     = "FzfLuaFzfNormal",
     cursorline = "FzfLuaFzfCursorLine",

lua/fzf-lua/init.lua

@@ -113,6 +113,10 @@ function M.setup_highlights(override)
       { default = default, fg = is_light and "CadetBlue4" or "LightSkyBlue1", bold = true } },
     { "FzfLuaTabMarker", "tab_marker", -- tabs only
       { default = default, fg = is_light and "MediumSpringGreen" or "BlanchedAlmond", bold = true } },
+    -- commands
+    { "FzfLuaCmdEx",         "cmd_ex",         { default = default, link = "Statement" } },
+    { "FzfLuaCmdBuf",        "cmd_buf",        { default = default, link = "Added" } },
+    { "FzfLuaCmdGlobal",     "cmd_global",     { default = default, link = "Directory" } },
     -- highlight groups for `fzf_colors=true`
     { "FzfLuaFzfNormal",     "fzf.normal",     { default = default, link = "FzfLuaNormal" } },
     { "FzfLuaFzfCursorLine", "fzf.cursorline", { default = default, link = "FzfLuaCursorLine" } },

lua/fzf-lua/providers/nvim.lua

@@ -74,14 +74,14 @@ M.commands = function(opts)
 
   opts.flatten = opts.flatten or {}
   for k, _ in pairs(global_commands) do
-    table.insert(entries, utils.ansi_codes.blue(k))
-    add_subcommand(k, utils.ansi_codes.blue)
+    table.insert(entries, utils.ansi_codes[opts.hls.cmd_global](k))
+    add_subcommand(k, utils.ansi_codes.cmd_global)
   end
 
   for k, v in pairs(buf_commands) do
     if type(v) == "table" then
-      table.insert(entries, utils.ansi_codes.green(k))
-      add_subcommand(k, utils.ansi_codes.green)
+      table.insert(entries, utils.ansi_codes[opts.hls.cmd_buf](k))
+      add_subcommand(k, utils.ansi_codes[opts.hls.cmd_buf])
     end
   end
 
@@ -91,7 +91,7 @@ M.commands = function(opts)
   end
 
   for k, _ in pairs(builtin_commands) do
-    table.insert(entries, utils.ansi_codes.magenta(k))
+    table.insert(entries, utils.ansi_codes[opts.hls.cmd_ex](k))
   end
 
   opts.preview = function(args)