Blink.pairs

<p align="center"> <h2 align="center">Blink Pairs (blink.pairs)</h2> </p> <p align="center"> Intelligent auto-pairs with rainbow highlighting for Neovim </p>

blink.pairs combines auto-pairs with rainbow highlighting, via a custom internal parser. The parser takes ~2ms to parse a 400k character file, and ~0.15ms for incremental updates. It uses indent-aware matching of delimiters and highlights mismatched pairs. See the roadmap for the current status, contributions welcome!

• Works out of the box with no additional configuration
• Rainbow highlighting of pairs
• Indent-aware matching of delimiters to highlight mismatched pairs
• Wrapping via motions (dot-repeatable) or treesitter
• Updates on every keystroke (<0.2ms)

<img width="900" src="https://github.com/user-attachments/assets/754479b0-1820-4fdb-b205-cbeafe894778" alt="Screenshot" />

code from frizbee, font iosevka, theme one-dark with catppuccin bg

Behavior

The behavior was inspired by lexima.vim and nvim-autopairs

| Before | Input | After | |----------|---------|----------| | \| | ( | (\|) | | \|) | ( | (\|) | | \| | " | "\|" | | ""\| | " | """\|""" | | ''\| | ' | '''\|''' | | \\| | [ | \[\| | | \\| | " | \"\| | | \\| | ' | \'\| | | A | ' | A' | | (\|) | ) | ()\| | | ((\|) | ) | (()\|) | | '\|' | ' | ''\| | | '''\|''' | ' | ''''''\| | | (\|) | <BS> | \| | | '\|' | <BS> | \| | | ( \| ) | <BS> | (\|) | | (\|) | <Space> | ( \| ) | | foo(\|)'bar' | <C-b>aq | foo('bar'\|) |

Installation

{
  'saghen/blink.pairs',
  version = '*', -- (recommended) only required with prebuilt binaries

  -- download prebuilt binaries from github releases
  dependencies = 'saghen/blink.download',
  -- OR build from source, requires nightly:
  -- https://rust-lang.github.io/rustup/concepts/channels.html#working-with-nightly-rust
  -- build = 'cargo build --release',
  -- If you use nix, you can build from source using latest nightly rust with:
  -- build = 'nix run .#build-plugin',

  --- @module 'blink.pairs'
  --- @type blink.pairs.Config
  opts = {
    mappings = {
      -- you can call require("blink.pairs.mappings").enable()
      -- and require("blink.pairs.mappings").disable()
      -- to enable/disable mappings at runtime
      enabled = true,
      cmdline = true,
      -- or disable with `vim.g.pairs = false` (global) and `vim.b.pairs = false` (per-buffer)
      -- and/or with `vim.g.blink_pairs = false` and `vim.b.blink_pairs = false`
      disabled_filetypes = {},
      wrap = {
        -- move closing pair via motion
        ['<C-b>'] = 'motion',
        -- move opening pair via motion
        ['<C-S-b>'] = 'motion_reverse',
        -- set to 'treesitter' or 'treesitter_reverse' to use treesitter instead of motions
        -- set to nil, '' or false to disable the mapping
        -- normal_mode = {} <- for normal mode mappings, only supports 'motion' and 'motion_reverse'
      },
      -- see the defaults:
      -- https://github.com/Saghen/blink.pairs/blob/main/lua/blink/pairs/config/mappings.lua#L52
      pairs = {},
    },
    highlights = {
      enabled = true,
      -- requires require('vim._extui').enable({}), otherwise has no effect
      cmdline = true,
      -- set to { 'BlinkPairs' } to disable rainbow highlighting
      groups = { 'BlinkPairsOrange', 'BlinkPairsPurple', 'BlinkPairsBlue' },
      unmatched_group = 'BlinkPairsUnmatched',

      -- highlights matching pairs under the cursor
      matchparen = {
        enabled = true,
        -- known issue where typing won't update matchparen highlight, disabled by default
        cmdline = false,
        -- also include pairs not on top of the cursor, but surrounding the cursor
        include_surrounding = false,
        group = 'BlinkPairsMatchParen',
        priority = 250,
      },
    },
    debug = false,
  }
}