feat: initial commit of Bufferinator.nvim

- Modern, modular Neovim buffer management plugin
- Dynamic floating menu with border for buffer actions:
  - Close hidden buffers
  - Close current buffer
  - Close all buffers except current
  - Close all buffers (including current)
- Easily overridable keymap and options (default: <C-q>)
- :BufferinatorMenu command to open the menu
- LuaDoc-style API documentation
- Neovim help file (doc/bufferinator.txt)
- Automated tests using plenary.nvim (tests/)
- MIT license and detailed README
- No runtime plugin dependencies (except for tests)

Author: mthnglac

.github/workflows/ci.yml

@@ -0,0 +1,28 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Neovim
+        uses: rhysd/action-setup-vim@v1
+        with:
+          neovim: true
+          version: stable
+
+      - name: Install plenary.nvim
+        run: |
+          mkdir -p ~/.local/share/nvim/site/pack/test/start
+          git clone --depth 1 https://github.com/nvim-lua/plenary.nvim ~/.local/share/nvim/site/pack/test/start/plenary.nvim
+
+      - name: Run tests
+        run: |
+          nvim --headless -c "PlenaryBustedDirectory tests/" +qall

.gitignore

@@ -0,0 +1,29 @@
+# Lua bytecode
+*.luac
+
+# Neovim swap, backup, undo files
+*.swp
+*.swo
+*.swn
+*.bak
+*.tmp
+*.undo
+
+# OS-specific files
+.DS_Store
+Thumbs.db
+
+# Test output
+test_output/
+output/
+*.log
+
+# Node/npm (bazı kullanıcılar için)
+node_modules/
+package-lock.json
+npm-debug.log
+
+# Neovim package manager artifacts (optional)
+site/
+plugged/
+pack/

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 YOUR NAME
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,75 @@
+# Bufferinator.nvim
+
+> Epic, humorous, and modern buffer management plugin for Neovim — nuke, blast, or yeet your buffers with style!
+
+---
+
+## Features
+
+- 🧨 Dynamic floating menu with border for buffer actions
+- 🚀 Close hidden buffers, current buffer, all except current, or all buffers
+- 🎛️ Easily overridable keymap and options (default: `<C-q>`)
+- 🧩 Optionally disable built-in keymaps and use only the `:BufferinatorMenu` command
+- 📝 LuaDoc-style API documentation & Neovim help file (`:help bufferinator`)
+- 🧪 Automated tests with plenary.nvim
+- 🪶 No runtime plugin dependencies (except for tests)
+- ⚖️ MIT License
+
+---
+
+## Installation
+
+**With [lazy.nvim](https://github.com/folke/lazy.nvim):**
+
+```lua
+{
+  "mthnglac/bufferinator.nvim",
+  config = function() require("bufferinator").setup() end -- or use `config = true`
+}
+```
+
+---
+
+## Configuration & Usage
+
+```lua
+require("bufferinator").setup({
+  -- Default keymap to open the menu (normal mode)
+  keymap = "<C-q>",
+
+  -- Set to true to disable built-in keymaps
+  -- Only use the :BufferinatorMenu command or your own keymap
+  disable_keymaps = false,
+})
+
+-- Example: set your own keymap to open the menu via the command
+-- vim.keymap.set("n", "<leader>bm", function() vim.cmd("BufferinatorMenu") end)
+```
+
+---
+
+## Bufferinator Menu Options
+
+1. Cancel the action
+2. Close hidden buffers
+3. Close current buffer
+4. Close all buffers except current
+5. Close all buffers (including current)
+
+---
+
+## Commands
+
+- `:BufferinatorMenu` — Open the Bufferinator floating menu
+
+---
+
+## Documentation
+
+- `:help bufferinator` for full help and usage details.
+
+---
+
+## License
+
+MIT

doc/bufferinator.txt

@@ -0,0 +1,47 @@
+*bufferinator.txt*      Epic buffer management for Neovim
+
+==============================================================================
+NAME
+    Bufferinator.nvim
+
+DESCRIPTION
+    Bufferinator.nvim is an epic, humorous buffer management plugin for Neovim.
+    It provides a floating menu to quickly close hidden, current, or all buffers.
+
+==============================================================================
+INSTALLATION
+
+    " With lazy.nvim
+        { "mthnglac/bufferinator.nvim", config = true }
+
+==============================================================================
+USAGE
+
+    :lua require("bufferinator").setup()
+
+    By default, press <C-q> to open the Bufferinator menu.
+
+    To customize the keymap:
+        :lua require("bufferinator").setup({ keymap = "<leader>bb" })
+
+==============================================================================
+MENU OPTIONS
+
+    1. Cancel the action
+    2. Close hidden buffers
+    3. Close current buffer
+    4. Close all buffers except current
+    5. Close all buffers (including current)
+
+==============================================================================
+API
+
+    require("bufferinator").setup({ keymap = "<C-q>" })
+
+==============================================================================
+LICENSE
+
+    MIT
+
+==============================================================================
+vim:tw=78:ts=8:ft=help:norl:

lua/bufferinator/actions.lua

@@ -0,0 +1,44 @@
+--- Bufferinator buffer actions
+-- @module bufferinator.actions
+
+local M = {}
+
+--- Close all hidden buffers except the current one.
+function M.close_hidden_buffers()
+  local current_buf = vim.api.nvim_get_current_buf()
+  for _, buf in ipairs(vim.api.nvim_list_bufs()) do
+    if buf ~= current_buf and vim.api.nvim_buf_is_loaded(buf) and vim.fn.bufwinnr(buf) == -1 then
+      vim.api.nvim_buf_delete(buf, { force = true })
+    end
+  end
+  vim.notify("Hidden buffers closed", vim.log.levels.INFO)
+end
+
+--- Close all buffers except the current one.
+function M.close_other_buffers()
+  local current_buf = vim.api.nvim_get_current_buf()
+  for _, buf in ipairs(vim.api.nvim_list_bufs()) do
+    if buf ~= current_buf and vim.api.nvim_buf_is_loaded(buf) then
+      vim.api.nvim_buf_delete(buf, { force = true })
+    end
+  end
+  vim.notify("Other buffers closed", vim.log.levels.INFO)
+end
+
+--- Close all buffers, including the current one.
+function M.close_all_buffers()
+  for _, buf in ipairs(vim.api.nvim_list_bufs()) do
+    if vim.api.nvim_buf_is_loaded(buf) then
+      vim.api.nvim_buf_delete(buf, { force = true })
+    end
+  end
+  vim.notify("All buffers closed", vim.log.levels.INFO)
+end
+
+--- Close the current buffer.
+function M.close_current_buffer()
+  vim.cmd("bd")
+  vim.notify("Current buffer closed", vim.log.levels.INFO)
+end
+
+return M

lua/bufferinator/commands.lua

@@ -0,0 +1,16 @@
+--- Bufferinator command setup
+-- @module bufferinator.commands
+
+local menu = require("bufferinator.menu")
+
+local M = {}
+
+--- Setup Bufferinator user commands
+-- Defines :BufferinatorMenu command to open the menu.
+function M.setup_commands()
+  vim.api.nvim_create_user_command("BufferinatorMenu", function()
+    menu.open()
+  end, { desc = "Open Bufferinator menu" })
+end
+
+return M

lua/bufferinator/init.lua

@@ -0,0 +1,27 @@
+--- Bufferinator.nvim main module
+-- @module bufferinator
+
+local menu = require("bufferinator.menu")
+local keymaps = require("bufferinator.keymaps")
+local commands = require("bufferinator.commands")
+
+local default_opts = {
+	keymap = "<C-q>",
+	disable_keymaps = false,
+}
+
+local M = {}
+
+--- Setup Bufferinator.nvim
+-- @param opts table|nil Optional table of options:
+--   - keymap (string): Keymap to open the menu (default: "<C-q>")
+--   - disable_keymaps (boolean): If true, built-in keymaps are not set
+function M.setup(opts)
+	opts = vim.tbl_deep_extend("force", {}, default_opts, opts or {})
+	if not opts.disable_keymaps then
+		keymaps.setup_keymaps(opts, menu.open)
+	end
+	commands.setup_commands()
+end
+
+return M

lua/bufferinator/keymaps.lua

@@ -0,0 +1,18 @@
+--- Bufferinator keymap setup
+-- @module bufferinator.keymaps
+
+local M = {}
+
+--- Setup Bufferinator keymaps
+-- @param opts table Options table (expects 'keymap' key)
+-- @param menu_open_fn function Function to call when keymap is triggered
+function M.setup_keymaps(opts, menu_open_fn)
+  local key = opts.keymap or "<C-q>"
+  vim.keymap.set("n", key, menu_open_fn, {
+    noremap = true,
+    silent = true,
+    desc = "Open Bufferinator menu",
+  })
+end
+
+return M

lua/bufferinator/menu.lua

@@ -0,0 +1,79 @@
+--- Bufferinator menu module
+-- @module bufferinator.menu
+local actions = require("bufferinator.actions")
+
+local M = {}
+
+--- Open the Bufferinator floating menu.
+-- Shows buffer management options in a floating window.
+function M.open()
+	local menu = {
+		{
+			desc = "Cancel the action",
+			action = function()
+				vim.notify("Cancelled", vim.log.levels.INFO)
+			end,
+		},
+		{ desc = "Close hidden buffers", action = actions.close_hidden_buffers },
+		{ desc = "Close current buffer", action = actions.close_current_buffer },
+		{ desc = "Close all buffers except current", action = actions.close_other_buffers },
+		{ desc = "Close all buffers (including current)", action = actions.close_all_buffers },
+	}
+
+	local lines = {
+		"Select action:",
+		"1: " .. menu[1].desc,
+		"2: " .. menu[2].desc,
+		"3: " .. menu[3].desc,
+		"4: " .. menu[4].desc,
+		"5: " .. menu[5].desc,
+		"",
+		"Press number or q/Esc/Ctrl+C to cancel",
+	}
+
+	local width = 0
+	for _, line in ipairs(lines) do
+		width = math.max(width, #line)
+	end
+	width = width + 4
+
+	local height = #lines + 2
+
+	local buf = vim.api.nvim_create_buf(false, true)
+	vim.api.nvim_buf_set_lines(buf, 0, -1, false, lines)
+	vim.bo[buf].modifiable = false
+	vim.bo[buf].buftype = "nofile"
+	vim.bo[buf].bufhidden = "wipe"
+	vim.bo[buf].swapfile = false
+
+	local win = vim.api.nvim_open_win(buf, true, {
+		relative = "editor",
+		width = width,
+		height = height,
+		row = math.floor((vim.o.lines - height) / 2),
+		col = math.floor((vim.o.columns - width) / 2),
+		style = "minimal",
+		border = "rounded",
+		zindex = 1000,
+	})
+
+	local function close_menu()
+		if vim.api.nvim_win_is_valid(win) then
+			vim.api.nvim_win_close(win, true)
+		end
+	end
+
+	for i = 1, #menu do
+		vim.keymap.set("n", tostring(i), function()
+			close_menu()
+			menu[i].action()
+		end, { buffer = buf, nowait = true, noremap = true, silent = true })
+	end
+	vim.keymap.set("n", "q", close_menu, { buffer = buf, nowait = true, noremap = true, silent = true })
+	vim.keymap.set("n", "<Esc>", close_menu, { buffer = buf, nowait = true, noremap = true, silent = true })
+	vim.keymap.set("n", "<C-c>", close_menu, { buffer = buf, nowait = true, noremap = true, silent = true })
+
+	vim.cmd("normal! gg")
+end
+
+return M