chore(nvim): more tweaks, cleanup and docs

config/nvim/lua/plugins/telescope.lua

@@ -8,7 +8,51 @@ return {
     { 'nvim-lua/plenary.nvim' },
     { 'nvim-telescope/telescope-symbols.nvim' },
     { 'folke/which-key.nvim' },
-    { 'ThePrimeagen/harpoon' },
+    -- Getting you where you want with the fewest keystrokes.
+    -- https://github.com/ThePrimeagen/harpoon
+    {
+      'ThePrimeagen/harpoon',
+      branch = 'harpoon2',
+      dependencies = {
+        'nvim-lua/plenary.nvim',
+        'nvim-telescope/telescope.nvim',
+      },
+      config = function()
+        local harpoon = require 'harpoon'
+        harpoon:setup {}
+
+        -- basic telescope configuration
+        local conf = require('telescope.config').values
+        local function toggle_telescope(harpoon_files)
+          local file_paths = {}
+          for _, item in ipairs(harpoon_files.items) do
+            table.insert(file_paths, item.value)
+          end
+
+          require('telescope.pickers')
+            .new({}, {
+              prompt_title = 'Harpoon',
+              finder = require('telescope.finders').new_table {
+                results = file_paths,
+              },
+              previewer = conf.file_previewer {},
+              sorter = conf.generic_sorter {},
+            })
+            :find()
+        end
+
+        vim.keymap.set('n', '<leader>hw', function()
+          toggle_telescope(harpoon:list())
+        end, { desc = 'Open harpoon window with telescope' })
+        vim.keymap.set('n', '<leader>ht', function()
+          harpoon.ui:toggle_quick_menu(harpoon:list())
+        end, { desc = 'Open Harpoon Quick menu' })
+      end,
+    },
+    -- A Telescope picker to quickly access configurations
+    -- of plugins managed by lazy.nvim.
+    -- https://github.com/polirritmico/telescope-lazy-plugins.nvim
+    { 'polirritmico/telescope-lazy-plugins.nvim' },
 
     -- Fuzzy Finder Algorithm which requires local dependencies to be built.
     -- Only load if `make` is available
@@ -47,16 +91,17 @@ return {
     -- Load extensions
     pcall(t.load_extension, 'harpoon')
     pcall(t.load_extension, 'git_worktree')
+    pcall(t.load_extension, 'lazy_plugins')
+
     -- Enable telescope fzf native, if installed
     pcall(t.load_extension, 'fzf')
 
     -- [[ Telescope Keymaps ]]
     -- See `:help telescope.builtin`
     -- See `:help telescope.keymap`
-    local b = require 'telescope.builtin'
     vim.keymap.set('n', '<leader>/', function()
       -- You can pass additional configuration to telescope to change theme, layout, etc.
-      b.current_buffer_fuzzy_find(themes.get_dropdown {
+      require('telescope.builtin').current_buffer_fuzzy_find(themes.get_dropdown {
         winblend = 10,
         previewer = true,
       })