feat: added `module=false` to skip auto-loading of plugins on `require`

README.md

@@ -108,6 +108,9 @@ module of plugin `A`, then plugin `A` will be loaded on demand as expected.
 
 You can configure **lazy.nvim** to lazy-load all plugins by default with `config.defaults.lazy = true`.
 
+If you don't want this behavior for a certain plugin, you can specify that with `module=false`.
+You can then manually load the plugin with `:Lazy load foobar.nvim`.
+
 Additionally, you can also lazy-load on **events**, **commands**,
 **file types** and **key mappings**.
 

lua/lazy/core/loader.lua

@@ -194,7 +194,7 @@ end
 function M.autoload(modname)
   -- check if a lazy plugin should be loaded
   for _, plugin in pairs(Config.plugins) do
-    if not plugin._.loaded then
+    if not (plugin._.loaded or plugin.module == false) then
       for _, pattern in ipairs({ ".lua", "/init.lua" }) do
         local path = plugin.dir .. "/lua/" .. modname:gsub("%.", "/") .. pattern
         if vim.loop.fs_stat(path) then

lua/lazy/core/plugin.lua

@@ -26,6 +26,7 @@ local M = {}
 ---@field cmd? string[]
 ---@field ft? string[]
 ---@field keys? string[]
+---@field module? false
 
 ---@class LazyPluginRef
 ---@field branch? string