About

This is a rewrite of vim-libmodal using Neovim's Lua API.

Unfortunately, during vim-libmodal's development several problems with Vimscript became apparent. Because of this, I have decided to rewrite it using Lua. This project aims to be cross-compatable with vim-libmodal version 2.X.Y, with the only alterations being additions to the source code that have been made under the 2.x.y revision number.

funcref() cannot be used in libmodal#Enter or libmodal#Prompt, so nvim-libmodal is mostly compatable, but not completely.

• See |libmodal-usage| for more details.

Note that cross-compatability does not mean that vim-libmodal and nvim-libmodal can be installed at the same time— as a matter of fact, they are developed specifically to replace each other for specific platforms. If you use Vim, use vim-libmodal. If you use Neovim, use nvim-libmodal. If you are a plugin creator, all code that works for vim-libmodal will work with nvim-libmodal, but the reverse is not true.

Requirements

• Neovim 0.5+.
• vim-libmodal is not installed.

Usage

The following plugins have been constructed using nvim-libmodal:

• nvim-tabmode
• nvim-typora

The following samples have been constructed using nvim-libmodal:

• mode-codedoc
• mode-fugidiff
• The Official Lua Examples
• The Official Vimscript Examples

See vim-libmodal and the docs for more information.

Statusline

You can add libmodal modes to your status line by using feline.nvim or galaxyline.nvim or . You can find my configuration for feline.nvim here and galaxyline.nvim here— both of which leverage nvim-libmodal's in the statusbar.