modules/lsp/server: declare package defaults

Convert the `attrsOf (servers.nix)` option to a freeform submodule.

Declare a `servers.nix` option for each lsp server listed in
`lsp-packages.nix` that has a known nixpkgs package.

Author: MattSturgeon

modules/lsp/default.nix

@@ -2,13 +2,58 @@
   lib,
   config,
   options,
+  pkgs,
   ...
 }:
 let
   inherit (lib) types;
   inherit (lib.nixvim) toLuaObject;
 
   cfg = config.lsp;
+
+  mkServerModule = args: lib.modules.importApply ./server.nix ({ inherit pkgs; } // args);
+
+  mkServerOption =
+    name:
+    {
+      package ? null,
+      # lsp-packages.nix tracks some custom commands, however this is currently not used by `server.nix`
+      cmd ? null,
+    }:
+    let
+      # Get the package so we can link to its homepage
+      homepage = lib.pipe options.lsp.servers [
+        # Get suboptions of `lsp.servers`
+        (opt: opt.type.getSubOptions opt.loc)
+        # Get suboptions of `lsp.servers.<name>`
+        (opts: opts.${name}.type.getSubOptions opts.${name}.loc)
+        # Get package option's homepage
+        (opts: opts.package.default.meta.homepage or null)
+      ];
+
+      nameLink = if homepage == null then name else "[${name}](${homepage})";
+    in
+    lib.mkOption {
+      type = types.submodule (mkServerModule {
+        inherit name package;
+      });
+      description = ''
+        The ${nameLink} language server.
+      '';
+      default = { };
+    };
+
+  # Combine `packages` and `customCmd` sets from `lsp-packages.nix`
+  # We use this set to generate the package-option defaults
+  serverPackages =
+    let
+      inherit (import ../../plugins/lsp/lsp-packages.nix)
+        packages
+        customCmd
+        ;
+      normalisedPackages = builtins.mapAttrs (_: package: { inherit package; }) packages;
+    in
+    normalisedPackages // customCmd;
 in
 {
   options.lsp = {
@@ -25,7 +70,11 @@ in
     };
 
     servers = lib.mkOption {
-      type = types.attrsOf (types.submodule ./server.nix);
+      type = types.submodule {
+        freeformType = types.attrsOf (types.submodule (mkServerModule { }));
+        options = builtins.mapAttrs mkServerOption serverPackages;
+      };
+
       description = ''
         LSP servers to enable and/or configure.
 
@@ -35,7 +84,7 @@ in
         This can be installed using [`${options.plugins.lspconfig.enable}`][`plugins.lspconfig`].
 
         [nvim-lspconfig]: ${options.plugins.lspconfig.package.default.meta.homepage}
-        [`plugins.lspconfig`]: ../plugins/lspconfig/index.md
+        [`plugins.lspconfig`]: ../../plugins/lspconfig/index.md
       '';
       default = { };
       example = {

modules/lsp/server.nix

@@ -1,59 +1,73 @@
+# Usage: lib.importApply ./server.nix { /*args*/ }
+{
+  name ? "the language server",
+  package ? null,
+  config ? null,
+  pkgs ? { },
+}:
+let
+  # module arg `name` shadows `name`
+  displayName = name;
+in
 { lib, name, ... }:
 let
   inherit (lib) types;
 in
 {
   options = {
-    enable = lib.mkEnableOption "the language server";
+    enable = lib.mkEnableOption displayName;
 
     name = lib.mkOption {
       type = types.maybeRaw types.str;
       description = ''
-        The name of the language server, supplied to functions like `vim.lsp.enable()`.
+        The name to use for ${displayName}.
+        Supplied to functions like `vim.lsp.enable()`.
       '';
       default = name;
       defaultText = lib.literalMD "the attribute name";
     };
 
+    package = lib.mkPackageOption pkgs (package.name or (lib.strings.removePrefix "the " displayName)) {
+      nullable = true;
+      default = package.default or package;
+      example = package.example or null;
+      extraDescription = ''
+        ${package.extraDescription or ""}
+
+        Alternatively, ${displayName} should be installed on your `$PATH`.
+      '';
+    };
+
     activate = lib.mkOption {
       type = types.bool;
       description = ''
-        Whether to call `vim.lsp.enable()` for this server.
+        Whether to call `vim.lsp.enable()` for ${displayName}.
       '';
       default = true;
       example = false;
     };
 
-    package = lib.mkOption {
-      type = with types; nullOr package;
-      default = null;
-      description = ''
-        Package to use for this language server.
-
-        Alternatively, the language server should be available on your `$PATH`.
-      '';
-    };
-
     config = lib.mkOption {
       type = with types; attrsOf anything;
       description = ''
-        Configurations for each language server.
+        Configurations for ${displayName}. ${config.extraDescription or ""}
       '';
       default = { };
-      example = {
-        cmd = [
-          "clangd"
-          "--background-index"
-        ];
-        root_markers = [
-          "compile_commands.json"
-          "compile_flags.txt"
-        ];
-        filetypes = [
-          "c"
-          "cpp"
-        ];
-      };
+      example =
+        config.example or {
+          cmd = [
+            "clangd"
+            "--background-index"
+          ];
+          root_markers = [
+            "compile_commands.json"
+            "compile_flags.txt"
+          ];
+          filetypes = [
+            "c"
+            "cpp"
+          ];
+        };
     };
   };
 }

plugins/by-name/lspconfig/default.nix

@@ -35,7 +35,7 @@ lib.nixvim.plugins.mkNeovimPlugin {
     > setup that relate to neovim's builtin LSP and are now being moved to the
     > new [`lsp`] module.
 
-    [`lsp`]: ../../lsp/servers.md
+    [`lsp`]: ../../lsp/servers/index.md
     [`plugins.lsp`]: ../lsp/index.md
     [nvim-lspconfig]: ${opts.package.default.meta.homepage}
   '';