feat: LSP and completion

README.md

@@ -16,7 +16,9 @@ virtual text.
 ### Main features
 
 - Find, filter, preview files with [telescope.nvim](https://github.com/nvim-telescope/telescope.nvim)
-- Programming languages support with [nvim-treesitter](https://github.com/nvim-treesitter/nvim-treesitter)
+- Syntax highlighting of any language with [nvim-treesitter](https://github.com/nvim-treesitter/nvim-treesitter)
+- Autocompletions with [nvim-cmp](https://github.com/hrsh7th/nvim-cmp)
+- LSP integration with [mason.nvim](https://github.com/williamboman/mason.nvim) and [nvim-lspconfig](https://github.com/neovim/nvim-lspconfig)
 - File explorer with [nvim-tree.lua](https://github.com/nvim-tree/nvim-tree.lua)
 - Git integration with [vim-fugitive](https://github.com/tpope/vim-fugitive) and [vim-gitgutter](https://github.com/airblade/vim-gitgutter)
 - GitHub integration with [vim-rhubarb](https://github.com/tpope/vim-rhubarb)
@@ -81,20 +83,53 @@ We don't overwrite \<Leader>. Defaults to the backslash (`\`) character.
 | normal           | `<C-p>`            | **Search** for **files** (respecting .gitignore) | `:Telescope find_files` |
 | normal           | `<C-b>`            | **Lists** open **buffers** in current neovim instance | `:Telescope buffers` |
 | normal           | `<C-g>`            | **Search** for a **string** and get results live as you type (respects .gitignore) | `:Telescope live_grep` |
+| normal           | `gd`               | Go **to** the **definition** of the symbol under the cursor | `:vim.lsp.buf.definition` |
+| normal           | `K`                | Displays **hover information** about the symbol under the cursor in a floating window.<br>Calling the function twice will jump into the floating window. | `:vim.lsp.buf.hover` |
+| normal           | `<Space>f`         | **Formats** a buffer using the attached language server clients | `:vim.lsp.buf.format({ async = true })` |
+| normal           | `<Space>e`         | **Show diagnostics** in a floating window | `:vim.diagnostic.open_float` |
+| normal           | `]d`               | Move to the **next diagnostic** | `:vim.diagnostic.goto_next` |
+| normal           | `[d`               | Move to the **previous diagnostic** | `:vim.diagnostic.goto_prev` |
 | normal<br>visual | `<C-Up>`           | Move line(s) up | |
 | normal<br>visual | `<C-Down>`         | Move line(s) down | |
 | normal<br>visual | `<Leader>c<Space>` | **Comment** or uncomment lines | `gcc`<br>`gc` |
+| insert           | `<C-n>`            | Invoke **completion** | `:cmp.complete` |
 
-## Install support for programming languages
+## Support for programming languages
 
-Using nvim-treesitter commands
+### Syntax highlighting
+
+Using nvim-treesitter commands:
 
 ```
 # inside nvim
+
 :TSInstall <language_to_install>
 ```
 
-More details: https://github.com/nvim-treesitter/nvim-treesitter?tab=readme-ov-file#language-parsers
+More details: https://github.com/nvim-treesitter/nvim-treesitter?tab=readme-ov-file#language-parsers.
+
+### Autocompletion and LSP
+
+Using mason-nvim commands:
+
+```
+# inside nvim
+
+:MasonInstall <language_to_install>
+```
+
+or
+
+```
+# inside nvim
+
+:Mason
+```
+
+to open the interactive mason window.
+
+More details: https://github.com/williamboman/mason.nvim?tab=readme-ov-file#commands.
+
 
 ## Check installation health
 

lazy-lock.json

@@ -1,5 +1,11 @@
 {
+  "cmp-buffer": { "branch": "main", "commit": "3022dbc9166796b644a841a02de8dd1cc1d311fa" },
+  "cmp-nvim-lsp": { "branch": "main", "commit": "5af77f54de1b16c34b23cba810150689a3a90312" },
   "lazy.nvim": { "branch": "main", "commit": "83493db50a434a4c5c648faf41e2ead80f96e478" },
+  "mason-lspconfig.nvim": { "branch": "main", "commit": "82c7cb08ddb836ad938b2708e50085f12a8825d2" },
+  "mason.nvim": { "branch": "main", "commit": "3b5068f0fc565f337d67a2d315d935f574848ee7" },
+  "nvim-cmp": { "branch": "main", "commit": "04e0ca376d6abdbfc8b52180f8ea236cbfddf782" },
+  "nvim-lspconfig": { "branch": "master", "commit": "8c1831817d40925d22cd8a555296c44c02fdaaf5" },
   "nvim-tree.lua": { "branch": "master", "commit": "f7c09bd72e50e1795bd3afb9e2a2b157b4bfb3c3" },
   "nvim-treesitter": { "branch": "master", "commit": "2014f8285e306f4c8a896c7d3af53fdd599e5a4f" },
   "nvim-treesitter-endwise": { "branch": "master", "commit": "60e8c288e011403f248b5f6478dde12bed8a6c55" },

lua/plugins.lua

@@ -1,9 +1,5 @@
 -- The below table will be merged with the rest of the plugin specs under `/lua/plugins/*.lua`
 return {
-  {
-    "airblade/vim-gitgutter",
-    event = "VeryLazy"
-  },
   {
     "bronson/vim-trailing-whitespace",
     event = "VeryLazy"

lua/plugins/completion.lua

@@ -0,0 +1,34 @@
+return {
+  "hrsh7th/nvim-cmp",
+  dependencies = {
+    'hrsh7th/cmp-buffer',
+    'hrsh7th/cmp-nvim-lsp',
+    "neovim/nvim-lspconfig"
+  },
+  event = "VeryLazy",
+  config = function()
+    local cmp = require('cmp')
+
+    cmp.setup({
+      completion = {
+        -- Can be quite distracting if enabled.
+        -- Manual completion via <C-n> possible.
+        autocomplete = false
+      },
+      window = {
+        completion = cmp.config.window.bordered({ border = "rounded" }),
+        documentation = cmp.config.window.bordered({ border = "rounded" })
+      },
+      mapping = cmp.mapping.preset.insert({
+        ['<C-e>'] = cmp.mapping.abort(),
+        ['<CR>'] = cmp.mapping.confirm({ select = false })
+      }),
+      sources = cmp.config.sources(
+        {
+          { name = 'nvim_lsp' },
+          { name = 'buffer' },
+        }
+      )
+    })
+  end
+}

lua/plugins/gitgutter.lua

@@ -0,0 +1,9 @@
+return {
+  "airblade/vim-gitgutter",
+  event = "VeryLazy",
+  config = function()
+    -- Deprioritize gitgutter signs over any other that has the default of 10.
+    -- Example vim.diagnostics generated by LSP.
+    vim.g.gitgutter_sign_priority = 5
+  end
+}

lua/plugins/lsp.lua

@@ -0,0 +1,88 @@
+return {
+  "neovim/nvim-lspconfig",
+  dependencies = {
+    "williamboman/mason.nvim",
+    "williamboman/mason-lspconfig.nvim"
+  },
+  config = function()
+    require("mason").setup()
+    require("mason-lspconfig").setup()
+
+    require("mason-lspconfig").setup_handlers({
+      -- The first entry (without a key) will be the default handler
+      -- and will be called for each installed server that doesn't have
+      -- a dedicated handler.
+      function(server_name) -- default handler (optional)
+        require("lspconfig")[server_name].setup({})
+      end,
+      -- Next, you can provide a dedicated handler for specific servers.
+      -- For example, a handler override for the `rust_analyzer`:
+      ["lua_ls"] = function()
+        require("lspconfig").lua_ls.setup({
+          settings = {
+            Lua = {
+              diagnostics = {
+                globals = {'vim'}
+              }
+            }
+          }
+        })
+      end
+    })
+
+    -- Use LspAttach autocommand to only map the following keys
+    -- after the language server attaches to the current buffer
+    vim.api.nvim_create_autocmd(
+      'LspAttach',
+      {
+        group = vim.api.nvim_create_augroup('UserLspConfig', {}),
+        callback = function(args)
+          -- Buffer local mappings.
+          -- See `:help vim.lsp.*` for documentation on any of the below functions
+          local opts = { buffer = args.buf }
+          local client = vim.lsp.get_client_by_id(args.data.client_id)
+
+          if client.server_capabilities.definitionProvider then
+            vim.keymap.set('n', 'gd', vim.lsp.buf.definition, opts)
+          end
+
+          if client.server_capabilities.hoverProvider then
+            vim.keymap.set('n', 'K', vim.lsp.buf.hover, opts)
+          end
+
+          if client.server_capabilities.documentFormattingProvider then
+            vim.keymap.set(
+              'n',
+              '<space>f',
+              function()
+                vim.lsp.buf.format({ async = true })
+              end,
+              opts
+            )
+          end
+        end
+      }
+    )
+
+    -- Reduce diagnostics noise by only keeping signcolumn signs enabled.
+    -- vim.diagnostic.open_float keymap below can be used to show more details.
+    vim.diagnostic.config({
+      signs = true,
+      underline = false,
+      virtual_text = false
+    })
+    vim.keymap.set('n', '<space>e', vim.diagnostic.open_float)
+    vim.keymap.set('n', '[d', vim.diagnostic.goto_prev)
+    vim.keymap.set('n', ']d', vim.diagnostic.goto_next)
+
+    -- Configures LSP hover window
+    local orig_util_open_floating_preview = vim.lsp.util.open_floating_preview
+    function vim.lsp.util.open_floating_preview(contents, syntax, opts, ...)
+      opts = opts or {}
+      opts.max_height = opts.max_height or 30
+      opts.max_width = opts.max_width or 120
+      opts.border = opts.border or "rounded"
+      return orig_util_open_floating_preview(contents, syntax, opts, ...)
+    end
+  end
+}