What is opts_extends for?

[calebdw]

Hello!

Can you please add some additional documentation and examples around opt_extends?
Here is my config:

---@type LazySpec
return {
  'saghen/blink.cmp',
  build = 'cargo build --release',
  event = 'InsertEnter',
  ---@module 'blink.cmp'
  ---@type blink.cmp.Config
  opts = {
    keymap = { preset = 'default' },
    appearance = { nerd_font_variant = 'normal' },
    completion = { documentation = { auto_show = true } },
    snippets = { preset = 'luasnip' },
    signature = { enabled = true },
    sources = {
      default = { 'lsp', 'path', 'snippets', 'buffer', 'emoji' },
      providers = {
        emoji = {
          module = "blink-emoji",
          name = "Emoji",
          score_offset = 15,
          should_show_items = function()
            return vim.tbl_contains(
              { "gitcommit", "markdown" },
              vim.o.filetype
            )
          end,
        }
      },
    },
  },
  opts_extend = { "sources.default" },
  dependencies = {
    { 'L3MON4D3/LuaSnip' },
    'moyiz/blink-emoji.nvim',
  },
}

It's not exactly clear how I'm supposed to use it---am I supposed to put the emoji provider into opts_extends? I don't really like having to duplicate all of the default providers just to add on to the list---is there a better way to do this?

I've poured over the docs but these questions just aren't clear...

Thanks!

[playbahn]

Looks like opts_extend isn't used anywhere in the code, possibly a case of outdated documentation.

$ rg --files-with-matches -e opts_extend
doc/installation.md
doc/blink-cmp.txt

[Saghen]

This is a lazy.nvim setting that forces lists to be merged, rather than replaced, when merging plugin specs together. For example:

{
  {
    'saghen/blink.cmp',
    opts_extend = { 'foo' },
    opts = { foo = { 'bar' } }
  },

  {
    'saghen/blink.cmp',
    opts = { foo = { 'baz' } }
  }
}

With opts_extend, the result will be foo = { 'bar', 'baz' }. Without it, the result will be foo = { 'baz' } (takes the latest value).

[playbahn]

Looks like opts_extend isn't used by lazy.nvim anymore.
https://github.com/search?type=code&q=repo%3Afolke%2Flazy.nvim%20opts_extend

[Saghen]

It is still used by lazy.nvim. https://github.com/folke/lazy.nvim/blob/6c3bda4aca61a13a9c63f1c1d1b16b9d3be90d7a/lua/lazy/core/plugin.lua#L466