feat!: Don't pollute command namespace for each action

https://github.com/nvim-neorocks/nvim-best-practices?tab=readme-ov-file#speaking_head-user-commands

Author: Allaman

README.md

@@ -30,6 +30,7 @@ Jokes aside, I could not find a plugin that fulfills my wish for both telescope
 
 - Automatic updates of available emojis via GitHub actions ([emojis-api.com](https://emoji-api.com/) as source).
 - No dependencies (relies on `vim.ui.select`).
+- (Optional) [fzf-lua](https://github.com/ibhagwan/fzf-lua) integration with `require("fzf-lua").register_ui_select()` (register fzf-lua as the UI interface for vim.ui.select)
 - (Optional) [telescope.nvim](https://github.com/nvim-telescope/telescope.nvim) integration (emojis only).
 - (Optional) [nvim-cmp](https://github.com/hrsh7th/nvim-cmp) integration (emojis only).
 
@@ -40,7 +41,7 @@ Jokes aside, I could not find a plugin that fulfills my wish for both telescope
 
 [![ui.png](https://s9.gifyu.com/images/SFndT.png)](https://gifyu.com/image/SFndT)
 
-Please note that I use [dressing.nvim](https://github.com/stevearc/dressing.nvim) so your UI might look different!
+Please note that I use [dressing.nvim](https://github.com/stevearc/dressing.nvim) in this picture so your UI might look different!
 
 </details>
 
@@ -83,6 +84,8 @@ With [Lazy.nvim](https://github.com/folke/lazy.nvim):
     "hrsh7th/nvim-cmp",
     -- optional for telescope integration
     "nvim-telescope/telescope.nvim",
+    -- optional for fzf-lua integration via vim.ui.select
+    "ibhagwan/fzf-lua",
   },
   opts = {
     -- default is false
@@ -121,17 +124,19 @@ require("telescope").load_extension("emoji")
 
 ### Emojis
 
-1. `:EmojiInsert` respective `lua require("emoji").insert()` or `:EmojiInsertByGroup` respective `lua require("emoji").insert_by_group()` allows you to select an emoji that is inserted at your cursor's current position.
-2. `:Telescope emoji` does the same but invokes Telescope instead of `vim.ui.select`. (if telescope.nvim is installed).
+1. `:Emoji` and `:Emoji insert` respective `lua require("emoji").insert()` or `:Emoji by-group` respective `lua require("emoji").insert_by_group()` allows you to select an emoji that is inserted at your cursor's current position.
+2. `:Telescope emoji` does the same but invokes Telescope instead of `vim.ui.select`. (if telescope.nvim is installed and the extension loaded).
 3. While in insert mode typing `:` triggers the auto-completion of nvim-cmp. (if nvim-cmp integration is enabled and configured).
 
 ### Kaomojis
 
-1. `:KaomojiInsert` respective `lua require("emoji").insert_kaomoji()`
-2. `:KaomojiInsertByGroup` respective `lua require("emoji").insert_kaomoji_by_group()`
+1. `:Emoji kaomoji` respective `lua require("emoji").insert_kaomoji()`
+2. `:Emoji kaomoji-by-group` respective `lua require("emoji").insert_kaomoji_by_group()`
 
 You can also create key bindings to your liking.
 
+Auto-completion in command mode is supported.
+
 ## 💡 Similar plugins and inspiration
 
 - [cmp-emoji](https://github.com/hrsh7th/cmp-emoji)

plugin/emoji.lua

@@ -1,27 +1,39 @@
-vim.api.nvim_create_user_command("EmojiInsert", function()
-  require("emoji").insert()
-end, {
-  desc = "Insert an Emoji at the cursor's current position",
-  nargs = 0,
-})
+local utils = require("emoji.utils")
 
-vim.api.nvim_create_user_command("EmojiInsertByGroup", function()
-  require("emoji").insert_by_group()
-end, {
-  desc = "Insert an Emoji, filtered by group, at the cursor's current position",
-  nargs = 0,
-})
+vim.api.nvim_create_user_command("Emoji", function(opts)
+  if #opts.fargs == 0 then
+    require("emoji").insert()
+    return
+  end
 
-vim.api.nvim_create_user_command("KaomojiInsert", function()
-  require("emoji").insert_kaomoji()
-end, {
-  desc = "Insert a Kaomoji at the cursor's current position",
-  nargs = 0,
-})
+  local subcommand = opts.fargs[1]
 
-vim.api.nvim_create_user_command("KaomojiInsertByGroup", function()
-  require("emoji").insert_kaomoji_by_group()
+  if subcommand == "insert" then
+    require("emoji").insert()
+  elseif subcommand == "by-group" then
+    require("emoji").insert_by_group()
+  elseif subcommand == "kaomoji" then
+    require("emoji").insert_kaomoji()
+  elseif subcommand == "kaomoji-by-group" then
+    require("emoji").insert_kaomoji_by_group()
+  else
+    utils.error("Unknown subcommand: " .. subcommand)
+  end
 end, {
-  desc = "Insert an Kaomoji, filtered by group, at the cursor's current position",
-  nargs = 0,
+  nargs = "*",
+  complete = function(argLead)
+    local subcommands = {
+      "insert",
+      "by-group",
+      "kaomoji",
+      "kaomoji-by-group",
+    }
+
+    local filtered = vim.tbl_filter(function(option)
+      return vim.startswith(option, argLead)
+    end, subcommands)
+
+    return filtered
+  end,
+  desc = "Emoji.nvim",
 })