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

diff --git a/lsp/slangd.lua b/lsp/slangd.lua
new file mode 100644
index 00000000..fc53ec6c
--- /dev/null
+++ b/lsp/slangd.lua
@@ -0,0 +1,35 @@
+local bin_name = 'slangd'
+
+if vim.fn.has 'win32' == 1 then
+  bin_name = 'slangd.exe'
+end
+
+---@brief
+---
+---https://github.com/shader-slang/slang
+--
+-- The `slangd` binary can be downloaded as part of [slang releases](https://github.com/shader-slang/slang/releases) or
+-- by [building `slang` from source](https://github.com/shader-slang/slang/blob/master/docs/building.md).
+--
+-- The server can be configured by passing a "settings" object to `slangd.setup{}`:
+--
+-- ```lua
+-- vim.lsp.config('slangd', {
+--   settings = {
+--     slang = {
+--       predefinedMacros = {"MY_VALUE_MACRO=1"},
+--       inlayHints = {
+--         deducedTypes = true,
+--         parameterNames = true,
+--       }
+--     }
+--   }
+-- })
+-- ```
+-- Available options are documented [here](https://github.com/shader-slang/slang-vscode-extension/tree/main?tab=readme-ov-file#configurations)
+-- or in more detail [here](https://github.com/shader-slang/slang-vscode-extension/blob/main/package.json#L70).
+return {
+  cmd = { bin_name },
+  filetypes = { 'hlsl', 'shaderslang' },
+  root_markers = { '.git' },
+}