---@type LazyPluginSpec
return {
  -- snippets
  {
    "L3MON4D3/LuaSnip",
    -- disable luasnip bindings for <tab> and <s-tab>
    dependencies = {
      {
        "honza/vim-snippets",
        config = function()
          require("luasnip.loaders.from_snipmate").lazy_load()
        end,
      },
    },
    keys = function()
      return {}
    end,
  },

  -- auto completion
  {
    "hrsh7th/nvim-cmp",
    ---@param opts cmp.ConfigSchema
    opts = function(_, opts)
      local has_words_before = function()
        unpack = unpack or table.unpack
        local line, col = unpack(vim.api.nvim_win_get_cursor(0))
        return col ~= 0 and vim.api.nvim_buf_get_lines(0, line - 1, line, true)[1]:sub(col, col):match("%s") == nil
      end

      local cmp = require("cmp")
      local luasnip = require("luasnip")

      opts.completion = vim.tbl_extend("force", opts.completion, {
        completeopt = "menu,menuone,noselect",
      })
      --TODO: review if I want to keep any of LazyVim's mappings
      opts.mapping = vim.tbl_extend("force", opts.mapping, {
        ["<Tab>"] = cmp.mapping(function(fallback)
          if cmp.visible() then
            cmp.select_next_item()
          elseif luasnip.expand_or_jumpable() then
            luasnip.expand_or_jump()
          elseif has_words_before() then
            cmp.complete()
          else
            fallback()
          end
        end, { "i", "s" }),
        ["<S-Tab>"] = cmp.mapping(function(fallback)
          if cmp.visible() then
            cmp.select_prev_item()
          elseif luasnip.jumpable(-1) then
            luasnip.jump(-1)
          else
            fallback()
          end
        end, { "i", "s" }),
      })
    end,
  },

  -- auto pairs
  {
    "echasnovski/mini.pairs",
  },

  -- surround
  {
    "echasnovski/mini.surround",
    keys = {
      { "S", "<cmd><C-u>lua MiniSurround.add('visual')<cr>", "x" },
      { "yss", "ys_", remap = true },
    },
    opts = {
      mappings = {
        -- TODO: this is tpope/surround like, but should consider using vim-sandwich mappings
        -- see: :h MiniSurround-vim-surround-config
        add = "ys",
        delete = "ds",
        find = "",
        find_left = "",
        highlight = "",
        replace = "cs",
        update_n_lines = "",
      },
    },
  },
  -- comments
  {
    "numToStr/Comment.nvim",
    opts = {
      toggler = {
        line = "gcc",
        block = "gbb",
      },
      mappings = {
        basic = true,
        extra = true,
      },
    },
  },
  { "JoosepAlviste/nvim-ts-context-commentstring", enabled = false },
  { "echasnovski/mini.comment", enabled = false },
}