https://github.com/Saghen/blink.compat

Compatibility layer for using nvim-cmp sources on blink.cmp
https://github.com/Saghen/blink.compat

Last synced: about 1 month ago
JSON representation

Compatibility layer for using nvim-cmp sources on blink.cmp

• Host: GitHub
• URL: https://github.com/Saghen/blink.compat
• Owner: Saghen
• License: mit
• Created: 2024-10-11T17:08:27.000Z (12 months ago)
• Default Branch: main
• Last Pushed: 2025-05-28T20:34:16.000Z (4 months ago)
• Last Synced: 2025-08-25T06:37:42.496Z (about 2 months ago)
• Language: Lua
• Size: 88.9 KB
• Stars: 191
• Watchers: 2
• Forks: 8
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Blink Compat (blink.compat)

**blink.compat** is a source provider for [blink.cmp](https://github.com/Saghen/blink.cmp)

that allow you to use [nvim-cmp](https://github.com/hrsh7th/nvim-cmp.git)

completion sources.

`blink.compat` will work for most `nvim-cmp` completion sources, but note that

there might be differences between using the source on `nvim-cmp` and on

`blink.cmp` through `blink.compat`, especially with regards to triggering

(due to `blink.cmp`'s lack of keyword patterns).

Developed by [@stefanboca](https://github.com/stefanboca)

## Note

Don't use `nvim-cmp` buffer, snippets, path, or lsp completion sources with

this `blink.compat`! While they might work, `blink.cmp` has native equivalents. Use

those instead!

## Usage

For each `nvim-cmp` source you want to use, add a provider with

`module = 'blink.compat.source'` and the same `name` that `nvim-cmp` uses.

Here's a minimal example adding the

[cmp-digraphs](https://github.com/dmitmel/cmp-digraphs) source provider in `lazy.nvim`

```lua

return {

  -- add blink.compat

  {

    'saghen/blink.compat',

    -- use v2.* for blink.cmp v1.*

    version = '2.*',

    -- lazy.nvim will automatically load the plugin when it's required by blink.cmp

    lazy = true,

    -- make sure to set opts so that lazy.nvim calls blink.compat's setup

    opts = {},

  },

  {

    'saghen/blink.cmp',

    version = '1.*',

    dependencies = {

      -- add source

      { 'dmitmel/cmp-digraphs' },

    },

    sources = {

      -- remember to enable your providers here

      default = { 'lsp', 'path', 'snippets', 'buffer', 'digraphs' },

      providers = {

        -- create provider

        digraphs = {

          -- IMPORTANT: use the same name as you would for nvim-cmp

          name = 'digraphs',

          module = 'blink.compat.source',

          -- all blink.cmp source config options work as normal:

          score_offset = -3,

          -- this table is passed directly to the proxied completion source

          -- as the `option` field in nvim-cmp's source config

          --

          -- this is NOT the same as the opts in a plugin's lazy.nvim spec

          opts = {

            -- this is an option from cmp-digraphs

            cache_digraphs_on_start = true,

          -- If you'd like to use a `name` that does not exactly match nvim-cmp,

          -- set `cmp_name` to the name you would use for nvim-cmp, for instance:

          -- cmp_name = "digraphs"

          -- then, you can set the source's `name` to whatever you like.

          },

        },

      },

    },

  },

}

```

## Options

A complete list of all configuration options and their defaults

```lua

opts = {

  -- print some debug information. Might be useful for troubleshooting

  debug = false,

}

```