blink-cmp-spell

spell source for blink.cmp based on Neovim's spellsuggest.

Usage

{
  'saghen/blink.cmp',
  dependencies = { 'ribru17/blink-cmp-spell' },
  opts = {
    -- ...

    sources = {
      default = {
        -- ...
        'spell'
      },
      providers = {
        -- ...
        spell = {
          name = 'Spell',
          module = 'blink-cmp-spell',
          opts = {
            -- EXAMPLE: Only enable source in `@spell` captures, and disable it
            -- in `@nospell` captures.
            enable_in_context = function()
              local curpos = vim.api.nvim_win_get_cursor(0)
              local captures = vim.treesitter.get_captures_at_pos(
                0,
                curpos[1] - 1,
                curpos[2] - 1
              )
              local in_spell_capture = false
              for _, cap in ipairs(captures) do
                if cap.capture == 'spell' then
                  in_spell_capture = true
                elseif cap.capture == 'nospell' then
                  return false
                end
              end
              return in_spell_capture
            end,
          },
        },
      },
    },


    -- It is recommended to put the "label" sorter as the primary sorter for the
    -- spell source.
    -- If you set use_cmp_spell_sorting to true, you may want to skip this step.
    fuzzy = {
      sorts = {
        function(a, b)
          local sort = require('blink.cmp.fuzzy.sort')
          if a.source_id == 'spell' and b.source_id == 'spell' then
            return sort.label(a, b)
          end
        end,
        -- This is the normal default order, which we fall back to
        'score',
        'kind',
        'label',
      },
    },
  },
}

Options

max_entries (integer, default 3)

The maximum number of results to be returned from the spellchecker.

preselect_current_word (boolean, default true)

If true and the spelling of the word is correct, the word is displayed as the first entry and preselected.

keep_all_entries (boolean, default false)

If true, all vim.fn.spellsuggest results are displayed in blink's menu. Otherwise, they are filtered to only include fuzzy matches.

use_cmp_spell_sorting (boolean, default false)

If true, then completion candidates will be sorted using the same algorithm used by cmp-spell. This can be helpful for sorting words that are partially typed. Otherwise, a custom sorting is used.

Note

If this option is set to true, then it is recommended that the fuzzy.sorts table is left to its default value.

enable_in_context (function, default function() return true end)

A function that, upon returning false, disables the completion source. This can be used to disable the spelling source when in a @nospell treesitter capture.

Shoutout

A huge thank you to @f3fora for the code inspiration from cmp-spell!