feat: migrate to vim.lsp.config #3659

Problem:
Nvim 0.11 has vim.lsp.config, which mostly replaces the legacy
nvim-lspconfig "framework".

Solution:
Migrate all configs to `lsp/*` variants. The old configs in
`lua/lspconfig/` are "frozen".

The new configs include these changes:
- `commands` field became raw calls to
  `vim.api.nvim_buf_create_user_command` inside `on_attach`.
- `root_dir` became:
  - `root_markers` whenever the file list was simple didn't need to mach `*`
  - if the logic was complicated, or needed to match something like
    '\*.c', it was defined as a vim.lsp.Config `root_dir` callback.
- `on_config_change` became `before_init`. I don't actually know if this
  is the correct approach, but looking around the documentation of
  `nvim-lspconfig` a saw that it was defined as the function that gets
  called as soon as the config have `root_dir`, and so I thought
  `before_init` might be the closest alternative.
- `docs.description` became a luadoc `@brief` docstring.
- `single_file_support = false`?

Co-authored-by: Aliou Diallo <aliou@users.noreply.github.com>
Co-authored-by: Justin M. Keyes <justinkz@gmail.com>

1 files changed, 27 insertions, 0 deletions

diff --git a/lsp/nelua_lsp.lua b/lsp/nelua_lsp.lua
new file mode 100644
index 00000000..629aa8fe
--- /dev/null
+++ b/lsp/nelua_lsp.lua
@@ -0,0 +1,27 @@
+-- https://github.com/codehz/nelua-lsp
+--
+-- nelua-lsp is an experimental nelua language server.
+--
+-- You need [nelua.vim](https://github.com/stefanos82/nelua.vim/blob/main/ftdetect/nelua.vim) for nelua files to be recognized or add this to your config:
+--
+-- in vimscript:
+-- ```vimscript
+-- au BufNewFile,BufRead *.nelua setf nelua
+-- ```
+--
+-- in lua:
+-- ```lua
+-- vim.api.nvim_create_autocmd({ "BufNewFile", "BufRead" }, { pattern = { "*.nelua" }, command = "setf nelua"})
+-- ```
+--
+-- **By default, nelua-lsp doesn't have a `cmd` set.** This is because nvim-lspconfig does not make assumptions about your path. You must add the following to your init.vim or init.lua to set `cmd` to the absolute path ($HOME and ~ are not expanded) of the unzipped run script or binary.
+--
+-- ```lua
+-- vim.lsp.config('nelua_lsp.setup, {
+--     cmd = { "nelua", "-L", "/path/to/nelua-lsp/", "--script", "/path/to/nelua-lsp/nelua-lsp.lua" },
+-- })
+-- ```
+return {
+  filetypes = { 'nelua' },
+  root_markers = { 'Makefile', '.git', '*.nelua' },
+}