{
  'mikkurogue/peekr.nvim',
  event = 'LspAttach',
  opts = {
    -- your configuration here
  },
}

use {
  'mikkurogue/peekr.nvim',
  config = function()
    require('peekr').setup({
      -- your configuration here
    })
  end,
}

vim.pack.add({ src = 'https://github.com/mikkurogue/peekr.nvim' })
require('peekr').setup({
  -- your configuration here
})

vim.keymap.set('n', 'gd', '<CMD>Peekr definitions<CR>')
vim.keymap.set('n', 'gr', '<CMD>Peekr references<CR>')
vim.keymap.set('n', 'gi', '<CMD>Peekr implementations<CR>')
vim.keymap.set('n', 'gD', '<CMD>Peekr type_definitions<CR>')

vim.keymap.set('n', 'gd', function() require('peekr').open('definitions') end)
vim.keymap.set('n', 'gr', function() require('peekr').open('references') end)

require('peekr').setup({
  height = 20,              -- float height in lines
  width = 0.75,             -- fraction of editor width (0.0 - 1.0)
  zindex = 50,
  border = 'rounded',       -- border style: 'rounded', 'single', 'double', 'solid', etc.

  preview_win_opts = {
    cursorline = true,
    number = true,
    wrap = true,
  },

  list = {
    position = 'left',      -- 'left' or 'right'
    width = 0.30,            -- fraction of the total float width
  },

  treesitter = {
    enable = true,           -- treesitter highlighting in preview
  },

  folds = {
    fold_closed = '',       -- nerd font icon for collapsed groups
    fold_open = '',         -- nerd font icon for expanded groups
    folded = true,           -- whether groups start folded
  },

  indent_lines = {
    enable = true,
    icon = '│',
  },

  winbar = {
    enable = true,           -- show winbar with filename and method info
  },

  use_trouble_qf = false,   -- use trouble.nvim for quickfix instead of :copen

  hooks = {
    ---Called before the Peekr window opens.
    ---@param results table       -- raw LSP results
    ---@param open function       -- call to proceed with opening
    ---@param jump function       -- call to jump to first result instead
    ---@param method string       -- the LSP method name
    before_open = function(results, open, jump, method) end,

    ---Called before the window closes.
    before_close = function() end,

    ---Called after the window closes.
    after_close = function() end,
  },

  mappings = {
    list = {
      ['j']         = actions.next,
      ['k']         = actions.previous,
      ['<Down>']    = actions.next,
      ['<Up>']      = actions.previous,
      ['<Tab>']     = actions.next_location,
      ['<S-Tab>']   = actions.previous_location,
      ['<CR>']      = actions.jump,
      ['o']         = actions.jump,
      ['v']         = actions.jump_vsplit,
      ['s']         = actions.jump_split,
      ['t']         = actions.jump_tab,
      ['l']         = actions.open_fold,
      ['h']         = actions.close_fold,
      ['<C-u>']     = actions.preview_scroll_win(5),
      ['<C-d>']     = actions.preview_scroll_win(-5),
      ['<leader>l'] = actions.enter_win('preview'),
      ['q']         = actions.close,
      ['Q']         = actions.close,
      ['<Esc>']     = actions.close,
      ['<C-q>']     = actions.quickfix,
    },
    preview = {
      ['<Tab>']     = actions.next_location,
      ['<S-Tab>']   = actions.previous_location,
      ['<leader>l'] = actions.enter_win('list'),
      ['q']         = actions.close,
      ['Q']         = actions.close,
      ['<Esc>']     = actions.close,
    },
  },
})

require('peekr').setup({
  hooks = {
    before_open = function(results, open, jump, method)
      -- Jump directly if there is only one result
      if #results == 1 then
        jump(results[1])
      else
        open(results)
      end
    end,
  },
})

require('peekr').register_method({
  name = 'my_method',
  label = 'My Method',
  method = 'custom/lspMethod',
  transform = function(results)
    -- transform raw LSP results into location items
    return results
  end,
})

local peekr = require('peekr')

peekr.setup(opts)                    -- configure the plugin
peekr.open('references')             -- open peek for a method
peekr.open('definitions', { ... })   -- open with per-call option overrides
peekr.is_open()                      -- returns true if the peek UI is visible
peekr.actions.close()                -- close the peek UI
peekr.actions.resume()               -- re-open the last session
peekr.register_method({ ... })       -- register a custom LSP method