menu test

Author: claydugo

README.md

@@ -8,12 +8,15 @@
 
 - **Open files in the browser**: Quickly open the current file in your remote Git repository's web interface.
 - **Line and Range Support**: Supports opening specific lines or ranges, including multiline selections from visual mode.
+- **Right-Click Menu**: Optional context menu with all browsher actions (requires [nvzone/menu](https://github.com/nvzone/menu)).
 - **Customizable providers**: Support for GitHub, GitLab, Sourcehut, and the ability to specify custom git web interfaces.
 - **Custom open commands**: Specify custom commands to open URLs (e.g., use a specific browser).
 
 # 📦 Installation
 Using [lazy.nvim](https://github.com/folke/lazy.nvim)
 
+## Basic Installation
+
 ```lua
 {
   'claydugo/browsher.nvim',
@@ -24,6 +27,35 @@ Using [lazy.nvim](https://github.com/folke/lazy.nvim)
   end
 }
 ```
+
+## Installation with Right-Click Menu
+
+For a full-featured right-click menu interface, install [nvzone/menu](https://github.com/nvzone/menu) separately and enable the menu feature:
+
+```lua
+-- Add menu dependencies (optional)
+{ "nvzone/volt", lazy = true },
+{ "nvzone/menu", lazy = true },
+
+-- Configure browsher with menu enabled
+{
+  'claydugo/browsher.nvim',
+  event = "VeryLazy",
+  config = function()
+    require('browsher').setup({
+      enable_menu = true,
+      menu_keybindings = {
+        keyboard = "<leader>bm",  -- Open menu with keyboard
+        mouse = true,              -- Enable right-click menu
+      },
+    })
+  end
+}
+```
+
+> [!NOTE]
+> The menu feature is completely optional. If `enable_menu = true` but the menu dependencies aren't installed, browsher will display a warning and continue working normally with the standard command interface.
+
 > [!IMPORTANT]
 > Please submit a Pull Request and add to this section if you have worked through installation instructions for other plugin managers!
 
@@ -44,6 +76,15 @@ require("browsher").setup({
     commit_length = nil,
     --- Allow line numbers with uncommitted changes.
     allow_line_numbers_with_uncommitted_changes = false,
+    --- Enable right-click menu integration using nvzone/menu
+    enable_menu = false,
+    --- Custom keybindings for the menu (when enable_menu is true)
+    menu_keybindings = {
+        --- Keybinding for opening menu with keyboard
+        keyboard = "<leader>bm",
+        --- Enable right-click mouse support
+        mouse = true,
+    },
     --- Command to open URLs (e.g., 'firefox').
     --- If this is a single character, it will be interpreted as a vim register
     --- instead. For example, to copy the url to your OS clipboard instead of
@@ -106,6 +147,8 @@ vim.api.nvim_set_keymap('v', '<leader>B', ":'<,'>Browsher tag<CR>gv", { noremap
 
 # 🚀 Usage
 
+## Command Line
+
 Use the `:Browsher` command to open the current file in your browser:
 
 ```
@@ -159,6 +202,27 @@ Select lines in visual mode and run:
 :Browsher
 ```
 
+## Right-Click Menu
+
+When the menu feature is enabled, you can:
+
+- Press `<leader>bm` (or your custom keyboard binding) to open the menu in normal or visual mode
+- **Visual mode**: Select lines and right-click to open the context menu with selection-specific options
+
+The menu provides these options:
+
+- **📍 Open at Commit** - Submenu with HEAD, HEAD~1, HEAD~2, etc. (up to HEAD~5)
+- **🌿 Open at Branch** - Open file at current branch
+- **🏷️ Open at Latest Tag** - Open file at latest tag
+- **🏠 Open Repository Root** - Open repository homepage
+- **📋 Copy URL (Commit)** - Submenu to copy URL for specific commits
+- **📋 Copy URL (Branch)** - Copy branch URL to clipboard
+
+Navigation:
+- `h` and `l` - Move between windows
+- `q` - Close menu
+- Press keybind or scroll and press Enter to execute
+
 # ⚠️ Notes
 
 * **Uncommitted Changes**: If the current file has uncommitted changes, line numbers may not correspond to what's on the remote repository. By default, line numbers are omitted when there are uncommitted changes unless `allow_line_numbers_with_uncommitted_changes` is set to true.

lua/browsher/config.lua

@@ -14,6 +14,15 @@ M.options = {
     open_cmd = nil,
     --- Allow line numbers with uncommitted changes.
     allow_line_numbers_with_uncommitted_changes = false,
+    --- Enable right-click menu integration using nvzone/menu
+    enable_menu = false,
+    --- Custom keybindings for the menu (when enable_menu is true)
+    menu_keybindings = {
+        --- Keybinding for opening menu with keyboard
+        keyboard = "<leader>bm",
+        --- Enable right-click mouse support
+        mouse = true,
+    },
     --- Custom providers for building URLs.
     ---
     --- Each provider is a table with the following keys:

lua/browsher/init.lua

@@ -197,6 +197,48 @@ end
 ---@param user_options table User-specified options.
 function M.setup(user_options)
     config.setup(user_options)
+
+    -- Setup menu keybindings if enabled and menu plugin is available
+    if config.options.enable_menu then
+        local has_menu = pcall(require, "menu")
+        if has_menu then
+            M.setup_menu()
+        else
+            utils.notify(
+                "Menu feature enabled but nvzone/menu not found. "
+                    .. "Install nvzone/volt and nvzone/menu to use the menu feature.",
+                vim.log.levels.WARN
+            )
+        end
+    end
+end
+
+--- Setup menu keybindings
+function M.setup_menu()
+    local menu_config = config.options.menu_keybindings
+
+    -- Setup keyboard binding (works in both normal and visual mode)
+    if menu_config.keyboard then
+        vim.keymap.set({ "n", "v" }, menu_config.keyboard, function()
+            require("browsher.menu").open()
+        end, { noremap = true, silent = true, desc = "Open Browsher menu" })
+    end
+
+    -- Setup mouse right-click binding (only in visual mode to preserve default right-click in normal mode)
+    if menu_config.mouse then
+        vim.keymap.set("v", "<RightMouse>", function()
+            -- Position cursor at mouse click
+            vim.cmd('normal! "\\<RightMouse>"')
+
+            -- Delete old menus if they exist
+            pcall(function()
+                require("menu.utils").delete_old_menus()
+            end)
+
+            -- Open browsher menu
+            require("browsher.menu").open({ mouse = true })
+        end, { noremap = true, silent = true, desc = "Open Browsher menu at mouse" })
+    end
 end
 
 return M