README.md

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.