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, 26 insertions, 0 deletions

diff --git a/lsp/pasls.lua b/lsp/pasls.lua
new file mode 100644
index 00000000..e2772dd4
--- /dev/null
+++ b/lsp/pasls.lua
@@ -0,0 +1,26 @@
+local util = require 'lspconfig.util'
+
+---@brief
+---
+---https://github.com/genericptr/pascal-language-server
+--
+-- An LSP server implementation for Pascal variants that are supported by Free Pascal, including Object Pascal. It uses CodeTools from Lazarus as backend.
+--
+-- First set `cmd` to the Pascal lsp binary.
+--
+-- Customization options are passed to pasls as environment variables for example in your `.bashrc`:
+-- ```bash
+-- export FPCDIR='/usr/lib/fpc/src'      # FPC source directory (This is the only required option for the server to work).
+-- export PP='/usr/lib/fpc/3.2.2/ppcx64' # Path to the Free Pascal compiler executable.
+-- export LAZARUSDIR='/usr/lib/lazarus'  # Path to the Lazarus sources.
+-- export FPCTARGET=''                   # Target operating system for cross compiling.
+-- export FPCTARGETCPU='x86_64'          # Target CPU for cross compiling.
+-- ```
+return {
+  cmd = { 'pasls' },
+  filetypes = { 'pascal' },
+  root_dir = function(bufnr, on_dir)
+    local fname = vim.api.nvim_buf_get_name(bufnr)
+    on_dir(util.root_pattern('*.lpi', '*.lpk', '.git')(fname))
+  end,
+}