languages/lua: move lazdev from lsp namespace to extensions and allow configuring it

Author: snoweuph

docs/manual/release-notes/rl-26.12.md

@@ -18,7 +18,13 @@
   into one module, because it creates scenarios where tools are connected to non
   supported filetypes.
 
-- `languages/lua`: only enable treesitter support if the module itself is enabled.
+- `languages/lua`: only enable treesitter support if the module itself is
+  enabled.
+
+- `languages/lua`: allow configuring lazydev and move it to the modules
+  `extensions` namespace. In this process the default options where also
+  removed, falling back to lazydevs own defaults. This was done, due to the old
+  defaults being extremely weird and what most people would never want.
 
 ## Changelog {#sec-release-26-12-changelog}
 

modules/extra/deprecations.nix

@@ -72,5 +72,10 @@ in {
       (mkRenamedOptionModule ["vim" "languages" "json" "treesitter" "json5Package"] ["vim" "languages" "json5" "treesitter" "package"])
       (mkRenamedOptionModule ["vim" "languages" "json" "treesitter" "jsonPackage"] ["vim" "languages" "json" "treesitter" "package"])
     ]
+
+    # 2026-08-07
+    [
+      (mkRenamedOptionModule ["vim" "languages" "lua" "lsp" "lazydev" "enable"] ["vim" "languages" "lua" "extensions" "lazydev" "enable"])
+    ]
   ];
 }

modules/plugins/languages/lua.nix

@@ -8,8 +8,7 @@
   inherit (lib.modules) mkIf mkMerge;
   inherit (lib) genAttrs;
   inherit (lib.types) enum listOf;
-  inherit (lib.nvim.types) mkGrammarOption;
-  inherit (lib.nvim.dag) entryBefore;
+  inherit (lib.nvim.types) mkGrammarOption mkPluginSetupOption;
 
   cfg = config.vim.languages.lua;
 
@@ -52,8 +51,6 @@ in {
         default = defaultServers;
         description = "Lua LSP server to use";
       };
-
-      lazydev.enable = mkEnableOption "lazydev.nvim integration, useful for neovim plugin developers";
     };
 
     format = {
@@ -83,6 +80,13 @@ in {
         description = "extra Lua diagnostics providers";
       };
     };
+
+    extensions = {
+      lazydev = {
+        enable = mkEnableOption "lazydev.nvim integration, useful for neovim plugin developers";
+        setupOpts = mkPluginSetupOption "lazydev" {};
+      };
+    };
   };
 
   config = mkIf cfg.enable (mkMerge [
@@ -100,18 +104,6 @@ in {
       };
     })
 
-    (mkIf cfg.lsp.lazydev.enable {
-      vim.startPlugins = ["lazydev-nvim"];
-      vim.pluginRC.lazydev = entryBefore ["lsp-servers"] ''
-        require("lazydev").setup({
-        	enabled = function(root_dir)
-        		return not vim.uv.fs_stat(root_dir .. "/.luarc.json")
-        	end,
-        	library = { { path = "''${3rd}/luv/library", words = { "vim%.uv" } } },
-        })
-      '';
-    })
-
     (mkIf cfg.format.enable {
       vim.formatter.conform-nvim = {
         enable = true;
@@ -129,5 +121,14 @@ in {
         };
       };
     })
+
+    (mkIf cfg.extensions.lazydev.enable {
+      vim.lazy.plugins.lazydev = {
+        package = "lazydev-nvim";
+        setupModule = "lazydev";
+        ft = "lua";
+        inherit (cfg.extensions.lazydev) setupOpts;
+      };
+    })
   ]);
 }