sentiment.nvim

Enhanced matchparen.vim plugin for Neovim to highlight the outer pair.

📹 Demo

DISCLAIMER: The autopair functionality is coming from nvim-autopairs.

demo.webm

✨ Features

🚀 Performance (Blazingly Fast!!!).
🪁 Fully compatible with anything that expects matchparen.vim to be there.
👍 Ease of use.

📦 Installation

NOTE: Keep in mind that calling setup disables the built-in matchparen.vim plugin.

lazy.nvim

{
  "utilyre/sentiment.nvim",
  version = "*",
  event = "VeryLazy", -- keep for lazy loading
  opts = {
    -- config
  },
  init = function()
    -- `matchparen.vim` needs to be disabled manually in case of lazy loading
    vim.g.loaded_matchparen = 1
  end,
}

packer.nvim

use({
  "utilyre/sentiment.nvim",
  tag = "*",
  config = function()
    require("sentiment").setup({
      -- config
    })
  end,
})

🎮 Usage

require("sentiment").disable(), :NoMatchParen

Disable the plugin.
require("sentiment").enable(), :DoMatchParen

Re-enable the plugin.

🎨 Highlight

This plugin re-uses the widely supported MatchParen highlight group of the former matchparen.vim plugin.

See :help nvim_set_hl() for how you can change it.

🚠 Configuration

Click to see the default config

{
  ---Dictionary to check whether a buftype should be included.
  ---
  ---@type table<string, boolean>
  included_buftypes = {
    [""] = true,
  },

  ---Dictionary to check whether a filetype should be excluded.
  ---
  ---@type table<string, boolean>
  excluded_filetypes = {},

  ---Dictionary to check whether a mode should be included.
  ---
  ---@type table<string, boolean>
  included_modes = {
    n = true,
    i = true,
  },

  ---How much (in milliseconds) should the cursor stay still to calculate and
  ---render a pair.
  ---
  ---NOTE: It's recommended to set this somewhere above and close to your key
  ---repeat speed in order to keep the calculations at minimum.
  ---
  ---@type integer
  delay = 50,

  ---How many lines to look backwards/forwards to find a pair.
  ---
  ---@type integer
  limit = 100,

  ---List of `(left, right)` pairs.
  ---
  ---NOTE: Both sides of a pair can't have the same character.
  ---
  ---@type tuple<string, string>[]
  pairs = {
    { "(", ")" },
    { "{", "}" },
    { "[", "]" },
  },
}

utilyre / sentiment.nvim