keymap-amend.nvim

Neovim v0.7 or higher is required

This plugin allows to amend the exisintg keybinding in Neovim. It is done with the
function which is required from the keymap-amend module. The signature of this function
is equal to vim.keymap.set function (:help vim.keymap.set()) with one exception: the
rhs parameter should be a function that receives one parameter — a function on call of
which the original keymapping will be executed. This function is constructed and passed
automaticaly. You only need to "accept" it in your rhs function and call on need.

local keymap = vim.keymap
keymap.amend = require('keymap-amend')

keymap.amend(mode, lhs, function(original)
    -- your custom logic
    original() -- execute the original 'lhs' mapping
end, opts)

You need to watch that the amendment happens after the original keymap is set.

Instalation

With packer:

use 'anuvyklack/keymap-amend.nvim'

Examples

local keymap = vim.keymap
keymap.amend = require('keymap-amend')

keymap.amend('n', 'k', function(original)
   print('k key is amended!')
   original()
end)

Make <Esc> disable highlighting of recently searched text in addition to its
original functionality:

local keymap = vim.keymap
keymap.amend = require('keymap-amend')

keymap.amend('n', '<Esc>', function(original)
   if vim.v.hlsearch and vim.v.hlsearch == 1 then
      vim.cmd('nohlsearch')
   end
   original()
end, { desc = 'disable search highlight' })

yank-ring with multiple-cursors

Make yanky.nvim and
vim-visual-multi plugins share <C-n>
key-chord. vim-visual-multi should be loaded before yanky.nvim. In this example
packer.nvim plugin manager is used to achive this.

use 'mg979/vim-visual-multi'
use { 'gbprod/yanky.nvim',
   after = 'vim-visual-multi',
   config = function() require('yanky').setup() end
}

keymap.amend('n', '<C-p>', function(original)
   if yanky.can_cycle() then
      yanky.cycle(-1)
   else
      original()
   end
end)

keymap.amend('n', '<C-n>', function(original)
   if yanky.can_cycle() then
      yanky.cycle(1)
   else
      original()
   end
end, { desc = 'yank-ring + multiple-cursors' })

Now <C-n> will cycle the yank-ring only after paste, in all other cases it will activate
multiple cursors.

Acknowledgments

This plugin was inspired with nvim-cmp
fallback mechanics.