feat(excmd): various test fixes and introducing excmd module

Author: asmodeus812

PICKERS.md

@@ -887,13 +887,13 @@ helptags_picker.open_helptags_picker({
 ### Manpages
 
 Lists man pages. Entries are collected from `apropos -k .` (fallback: `man -k .`) and normalized to `name(section)`. The user is allowed
-to provide a list of additional customized command arguments to pass down to the executable (man or apropos)
+to provide a list of additional customized arguments to pass down to the executable (man or apropos).
 
 ```lua
 local manpages_picker = require("fuzzy.pickers.manpages")
 
 manpages_picker.open_manpages_picker({
-    command_args = { "-k", "." }
+    args = { "-k", "." }
 })
 ```
 

README.md

@@ -10,12 +10,14 @@
             - [Primary stage](#primary-stage)
             - [Matching stage](#matching-stage)
     - [Features](#features)
+    - [PICKERS](#pickers)
     - [Description](#description)
     - [Installation](#installation)
         - [Using packer.nvim](#using-packernvimhttpsgithubcomwbthomasonpackernvim)
         - [Using lazy.nvim](#using-lazynvimhttpsgithubcomfolkelazynvim)
         - [Using vim-plug](#using-vim-plughttpsgithubcomjunegunnvim-plug)
     - [Configuration](#configuration)
+    - [User commands](#user-commands)
     - [Quickstart](#quickstart)
         - [Static table](#static-table)
         - [Callback function](#callback-function)
@@ -30,20 +32,21 @@
         - [Dynamic streams](#dynamic-streams)
         - [Contextual awareness](#contextual-awareness)
     - [Interaction](#interaction)
-        - [Interactive and Fuzzy stages](#interactive-and-fuzzy-stages)
-        - [Closing and hiding pickers](#closing-and-hiding-pickers)
+        - [Interactive & Matching stages](#interactive--matching-stages)
+        - [Closing & hiding pickers](#closing--hiding-pickers)
         - [Dynamic context evaluation](#dynamic-context-evaluation)
-        - [Picker actions & interaction](#picker-actions--interaction)
+        - [Actions & interaction](#actions--interaction)
         - [Picker Options](#picker-options)
         - [Core options](#core-options)
         - [Advanced options](#advanced-options)
         - [Option details](#option-details)
             - [Core options](#core-options-1)
             - [Advanced options](#advanced-options-1)
-        - [In-depth look](#in-depth-look)
+        - [In-depth description](#in-depth-description)
             - [Actions](#actions)
             - [Previewers](#previewers)
             - [Decorators](#decorators)
+            - [Highlighters](#highlighters)
             - [Converters](#converters)
     - [Examples](#examples)
         - [Interactive grep](#interactive-grep)
@@ -177,6 +180,10 @@ require("fuzzy").setup({
     general = {
         -- override the built-in `vim.ui.select` with fuzzymatch
         override_select = true,
+        user_command = {
+            enabled = true,
+            name = "Fzm",
+        },
     }
 
     -- Scheduler controls the async budget for cooperative tasks
@@ -203,6 +210,8 @@ require("fuzzy").setup({
 Configuration details:
 
 - `general.override_select`: Replaces `vim.ui.select` with the built-in picker-based implementation.
+- `general.user_command.enabled`: Registers the user command that opens pickers by name.
+- `general.user_command.name`: Command name used for pickers (default: `Fzm`).
 - `scheduler.async_budget`: Time budget in microseconds for cooperative async tasks.
 - `pool.max_idle`: Maximum idle time in milliseconds before a pooled table is discarded.
 - `pool.prune_interval`: Interval in milliseconds for pool cleanup.
@@ -226,6 +235,30 @@ when the picker is re-opened the context will be re-evaluated and if it has chan
 `TDDR;` To start using the picker simply require the picker and select modules those are going to be enough for you to create pretty much any
 type of picker you can imagine. Lets see a few examples
 
+### User command
+
+The `:Fzm` command opens any picker by name, with optional `key=value` arguments. You can change the
+command name with `general.user_command.name`.
+
+```vim
+:Fzm files
+:Fzm grep cwd=/path/to/project
+:Fzm grep args=--hidden,--iglob=*.lua prompt_query="init.lua"
+:Fzm manpages args=-k,. preview=false
+```
+
+- `cwd`: working directory (string)
+- `args`: comma-separated list (quoted strings supported)
+- `env`: comma-separated list (quoted strings supported)
+- `preview`: `true|false`
+- `icons`: `true|false`
+- `watch`: `true|false`
+- `prompt_query`: initial prompt string (quote if it contains spaces)
+- `prompt_debounce`, `match_limit`, `match_timer`, `match_step`, `stream_step`, `stream_debounce`: numbers
+- `stream_type`: `lines|bytes`
+- `window_size`: number (0-1)
+- `interactive`: `true|false`
+
 ### Static table
 
 Use a static table when you already have all entries in memory. This produces a non-interactive picker: the list is shown as-is and no

lua/fuzzy/init.lua

@@ -1,8 +1,6 @@
-Picker = require("fuzzy.picker")
-Pool = require("fuzzy.pool")
-Registry = require("fuzzy.registry")
-Scheduler = require("fuzzy.scheduler")
-Select = require("fuzzy.select")
+local Pool = require("fuzzy.pool")
+local Registry = require("fuzzy.registry")
+local Scheduler = require("fuzzy.scheduler")
 
 local M = {
     config = {},
@@ -11,7 +9,11 @@ local M = {
 function M.setup(opts)
     M.config = vim.tbl_deep_extend("keep", opts or {}, {
         general = {
-            override_select = true
+            override_select = true,
+            user_command = {
+                enabled = true,
+                name = "Fzm",
+            },
         },
         scheduler = {
             async_budget = 1 * 1e6,
@@ -42,6 +44,12 @@ function M.setup(opts)
         vim.ui.select = select_picker.open_select_picker
     end
 
+    local user_command = M.config.general.user_command or {}
+    if user_command.enabled then
+        local excmd = require("fuzzy.pickers.excmd")
+        excmd.register_user_commands(user_command.name)
+    end
+
     vim.api.nvim_set_hl(0, "SelectToggleSign", { link = "Special", default = false })
     vim.api.nvim_set_hl(0, "SelectPrefixText", { link = "Normal", default = false })
     vim.api.nvim_set_hl(0, "SelectStatusText", { link = "NonText", default = false })
@@ -50,13 +58,14 @@ function M.setup(opts)
     vim.api.nvim_set_hl(0, "SelectHeaderDefault", { link = "Normal", default = false })
     vim.api.nvim_set_hl(0, "SelectHeaderPadding", { link = "NonText", default = false })
     vim.api.nvim_set_hl(0, "SelectHeaderDelimiter", { link = "Ignore", default = false })
-    vim.api.nvim_set_hl(0, "SelectDecoratorDefault", { link = "Normal", default = false })
-    vim.api.nvim_set_hl(0, "SelectLineHighlight", { link = "Visual", default = false })
 
     vim.api.nvim_set_hl(0, "PickerHeaderActionKey", { link = "ErrorMsg", default = false })
     vim.api.nvim_set_hl(0, "PickerHeaderActionLabel", { link = "MoreMsg", default = false })
     vim.api.nvim_set_hl(0, "PickerHeaderActionSeparator", { link = "ModeMsg", default = false })
 
+    vim.api.nvim_set_hl(0, "SelectLineHighlight", { link = "Normal", default = false })
+    vim.api.nvim_set_hl(0, "SelectDecoratorDefault", { link = "Normal", default = false })
+
     Pool.prime(pool_config.prime_sizes or {})
 end
 

lua/fuzzy/picker.lua

@@ -907,8 +907,8 @@ function Picker.new(opts)
         context = {
             args = {},
             env = nil,
+            cwd = nil,
             tick = nil,
-            cwd = vim.loop.cwd,
         },
         interactive = false,
         stream_map = nil,

lua/fuzzy/pickers/btags.lua

@@ -46,7 +46,7 @@ function M.open_btags_picker(opts)
         },
         highlighters = {
             Select.RegexHighlighter.new({
-                { "^%S+", "Identifier" },
+                { "^%S+", "Function" },
                 { "%s%[([^%]]+)%]$", "Type", 1 },
             }),
         },

lua/fuzzy/pickers/buffers.lua

@@ -241,7 +241,8 @@ function M.open_buffers_picker(opts)
         highlighters = {
             Select.RegexHighlighter.new({
                 { "^%d+", "Number" },
-                { "%s.+$", "Directory" },
+                { "^%d+%s+(.*/)", "Directory", 1 },
+                { "([^/]+)$", "Function", 1 },
             }),
         },
         display = function(entry)

lua/fuzzy/pickers/changes.lua

@@ -71,6 +71,11 @@ function M.open_changes_picker(opts)
         preview = opts.preview,
         actions = util.build_default_actions(conv, opts),
         decorators = decorators,
+        highlighters = {
+            Select.RegexHighlighter.new({
+                { "%d+:%d+", "Number" },
+            }),
+        },
         display = function(entry)
             return util.format_location_entry(
                 nil, entry.lnum or 1, entry.col or 1

lua/fuzzy/pickers/colorscheme.lua

@@ -74,6 +74,11 @@ function M.open_colorscheme_picker(opts)
         },
         preview = opts.preview,
         actions = actions,
+        highlighters = {
+            Select.RegexHighlighter.new({
+                { "^.+$", "Constant" },
+            }),
+        },
     }, opts, {
         match_timer = 5,
         match_step = 1000,

lua/fuzzy/pickers/command_history.lua

@@ -36,6 +36,12 @@ function M.open_command_history(opts)
                 return false
             end)),
         },
+        highlighters = {
+            Select.RegexHighlighter.new({
+                { "^%S+", "Statement" },
+                { "%s(.+)$", "Comment", 1 },
+            }),
+        },
     }, opts, {
         match_timer = 5,
         match_step = 1000,

lua/fuzzy/pickers/commands.lua

@@ -72,6 +72,11 @@ function M.open_commands_picker(opts)
                 return false
             end)),
         },
+        highlighters = {
+            Select.RegexHighlighter.new({
+                { "^%S+", "Statement" },
+            }),
+        },
     }, opts, {
         match_timer = 5,
         match_step = 2000,