feat: mini.snippets and snippets presets

[abeldekat]

Resolves #741

Tested with the LazyVim PR mentioned below. Snippets appear and can be expanded.

Checklist

• Expand and select
• Implement resolve function
• Correct caching

See also:

• cmp-mini-snippets
• LazyVim PR

[Saghen]

TODO: Should the new source be added to configurations.md

I can handle the documentation when it's ready for review

[abeldekat]

I can handle the documentation when it's ready for review

Great!

[abeldekat]

Ready for review.

I do hope I implemented caching correctly!

Given buf_id/ft combination, snippets don't change in a vim session.
In order to also reuse the generated documentation, I would like to change function resolve into:

function source:resolve(item, callback)
  local snip = item.data.snip

  ---@diagnostic disable-next-line: undefined-field
  local desc = snip.desc
  if desc and not item.documentation then
    item.documentation = {
      kind = 'markdown',
      value = table.concat(vim.lsp.util.convert_input_to_markdown_lines(desc), '\n'),
    }
  end

  ---@diagnostic disable-next-line: undefined-field
  local detail = snip.body
  if not item.detail then
    if type(detail) == 'table' then detail = table.concat(detail, '\n') end
    item.detail = detail
  end

  callback(item)
end

Question: Is the deepcopy to resolved_item on line 81 important? The suggested changes seem to be working fine.

[abeldekat]

@Saghen

I also committed the source:resolve I suggested in this comment.
If you don't agree I will revert the change.

[Saghen]

@echasnovski For the active function, we use vim.snippet.active({ direction = -1 | 1 }). I wasn't able to find an equivalent in mini.snippets, although it's not a deal breaker if this is unsupported

[echasnovski]

@echasnovski For the active function, we use vim.snippet.active({ direction = -1 | 1 }). I wasn't able to find an equivalent in mini.snippets, although it's not a deal breaker if this is unsupported

That would be MiniSnippets.session.get() ~= nil, which checks if there is an active session. Checking for "active in particular direction" does not make much sense with default_insert() since it wraps around the edge when jumping through tabstops. So if snippet session is active it is active in any direction.

[Saghen]

Makes sense, thank you!

[abeldekat]

I use it like this in Lazyvim PR

[Saghen]

Brilliant work, thank you @abeldekat! And thank you for the reviews @echasnovski!

[abeldekat]

That's great! Thank you both!