chore(main): release 11.17.5 (#2087)

🤖 I have created a release *beep* *boop*
---


##
[11.17.5](https://github.com/folke/lazy.nvim/compare/v11.17.4...v11.17.5)
(2025-11-06)


### Bug Fixes

* **luarocks:** proper parsing of dependency name. Closes
[#2086](https://github.com/folke/lazy.nvim/issues/2086)
([5c09e6f](5c09e6fe71))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

.github/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "11.14.1"
+  ".": "11.17.5"
 }

.markdownlint-cli2.yaml

@@ -0,0 +1,3 @@
+config:
+  MD013: false
+  MD033: false

CHANGELOG.md

@@ -1,5 +1,104 @@
 # Changelog
 
+## [11.17.5](https://github.com/folke/lazy.nvim/compare/v11.17.4...v11.17.5) (2025-11-06)
+
+
+### Bug Fixes
+
+* **luarocks:** proper parsing of dependency name. Closes [#2086](https://github.com/folke/lazy.nvim/issues/2086) ([5c09e6f](https://github.com/folke/lazy.nvim/commit/5c09e6fe71f4bb930eeffe24d45762fa3ffada4e))
+
+## [11.17.4](https://github.com/folke/lazy.nvim/compare/v11.17.3...v11.17.4) (2025-11-04)
+
+
+### Bug Fixes
+
+* **plugin:** proper error message when a plugin spec returns more than one value. ([dfdc85e](https://github.com/folke/lazy.nvim/commit/dfdc85e18930a3f1643e83c8ed0c514ca85e49fa))
+
+## [11.17.3](https://github.com/folke/lazy.nvim/compare/v11.17.2...v11.17.3) (2025-10-28)
+
+
+### Bug Fixes
+
+* **luarocks:** update to lumen-oss for binaries. Closes [#2060](https://github.com/folke/lazy.nvim/issues/2060). Closes [#2059](https://github.com/folke/lazy.nvim/issues/2059) ([e31789c](https://github.com/folke/lazy.nvim/commit/e31789c675e2f591a20fc894b6713398eaa5dddd))
+
+## [11.17.2](https://github.com/folke/lazy.nvim/compare/v11.17.1...v11.17.2) (2025-10-23)
+
+
+### Bug Fixes
+
+* **luarocks:** add plugin to lua path if it was already loaded before we know its a luarock ([147f5a3](https://github.com/folke/lazy.nvim/commit/147f5a3f55b5491bbc77a55ce846ef5eb575fa42))
+* **plugin:** check that path is actually in root dir. Closes [#2075](https://github.com/folke/lazy.nvim/issues/2075) ([16e5271](https://github.com/folke/lazy.nvim/commit/16e52715b70b4d0fc6af3563ccc0ed9df82ae23e))
+* **stats:** better support for different `time_t` sizes. See [#2049](https://github.com/folke/lazy.nvim/issues/2049) ([1ea3c40](https://github.com/folke/lazy.nvim/commit/1ea3c4085785f460fb0e46d2fe1ee895f5f9e7c1))
+
+## [11.17.1](https://github.com/folke/lazy.nvim/compare/v11.17.0...v11.17.1) (2025-02-25)
+
+
+### Bug Fixes
+
+* **bootstrap:** support for older Neovim versions ([1c9ba37](https://github.com/folke/lazy.nvim/commit/1c9ba3704564a2e34a22191bb89678680ffeb245))
+* **meta:** rebuild dirty right after disable. See [#1889](https://github.com/folke/lazy.nvim/issues/1889) ([d51cf69](https://github.com/folke/lazy.nvim/commit/d51cf6978321d659e68a8bc38ee806bd2517a196))
+
+## [11.17.0](https://github.com/folke/lazy.nvim/compare/v11.16.2...v11.17.0) (2025-02-24)
+
+
+### Features
+
+* **config,render:** allow customizing the debug icon ([#1863](https://github.com/folke/lazy.nvim/issues/1863)) ([a9c660d](https://github.com/folke/lazy.nvim/commit/a9c660d6ef1b396869d3d951760aa7a3dbfe575f))
+* **util:** pass lang to `vim.notify` so that snacks notifier can render the ft. Closes [#1919](https://github.com/folke/lazy.nvim/issues/1919) ([c6a57a3](https://github.com/folke/lazy.nvim/commit/c6a57a3534d3494bcc5ff9b0586e141bdb0280eb))
+
+
+### Bug Fixes
+
+* **config:** add missing space on the default debug icon ([#1879](https://github.com/folke/lazy.nvim/issues/1879)) ([4df5c4d](https://github.com/folke/lazy.nvim/commit/4df5c4d65a3bbf801edd9ec55fb1ae55cfa72dd0))
+* **meta:** disable top-level specs before the rest. Closes [#1889](https://github.com/folke/lazy.nvim/issues/1889) ([f81a3fb](https://github.com/folke/lazy.nvim/commit/f81a3fb7feaf460ec7c8c983682b4a693b18fdd4))
+* **ui:** do not show virt_lines for messages ([#1904](https://github.com/folke/lazy.nvim/issues/1904)) ([f15a939](https://github.com/folke/lazy.nvim/commit/f15a93907ddad3d9139aea465ae18336d87f5ce6))
+
+## [11.16.2](https://github.com/folke/lazy.nvim/compare/v11.16.1...v11.16.2) (2024-12-13)
+
+
+### Bug Fixes
+
+* **meta:** when a plugin is both optional and disabled, then just delete it from the list ([805b85c](https://github.com/folke/lazy.nvim/commit/805b85c2ea3bd6f9506ef22cbd6e3a39172b5b08))
+
+## [11.16.1](https://github.com/folke/lazy.nvim/compare/v11.16.0...v11.16.1) (2024-12-09)
+
+
+### Bug Fixes
+
+* **types:** ensure all fields for `LazyPluginSpec` are optional ([#1843](https://github.com/folke/lazy.nvim/issues/1843)) ([703be1d](https://github.com/folke/lazy.nvim/commit/703be1dda35e142e76e94e7503cf67d6b98a1d35)), closes [#1842](https://github.com/folke/lazy.nvim/issues/1842)
+
+## [11.16.0](https://github.com/folke/lazy.nvim/compare/v11.15.0...v11.16.0) (2024-12-07)
+
+
+### Features
+
+* **plugin:** added support for virtual plugins. Closes [#1836](https://github.com/folke/lazy.nvim/issues/1836) ([ee64abc](https://github.com/folke/lazy.nvim/commit/ee64abc76be2b237b95d241a924b0323005b868a))
+
+
+### Bug Fixes
+
+* **plugin:** don't check if dir exists for virtual plugins ([656cf43](https://github.com/folke/lazy.nvim/commit/656cf4309396b7b8b62984e923bf8d8a0013f7d7))
+* **render:** show correct key for home. Fixes [#1796](https://github.com/folke/lazy.nvim/issues/1796) ([b08dba8](https://github.com/folke/lazy.nvim/commit/b08dba8107b5bdaaa007f18cf6c0cc0e0fd576aa))
+
+## [11.15.0](https://github.com/folke/lazy.nvim/compare/v11.14.2...v11.15.0) (2024-12-05)
+
+
+### Features
+
+* **plugin:** show error for local plugins that don't exist. Fixes [#1773](https://github.com/folke/lazy.nvim/issues/1773) ([9570a5a](https://github.com/folke/lazy.nvim/commit/9570a5ae7b17dcde4718c7458fd986c10f015a99))
+
+## [11.14.2](https://github.com/folke/lazy.nvim/compare/v11.14.1...v11.14.2) (2024-11-10)
+
+
+### Bug Fixes
+
+* **bootstrap:** single forward slash. Fixes [#1747](https://github.com/folke/lazy.nvim/issues/1747) ([aca30f6](https://github.com/folke/lazy.nvim/commit/aca30f63619a7492ecdea8833a065cf83c80f764))
+* **completion:** check if command string is a prefix of Lazy ([#1760](https://github.com/folke/lazy.nvim/issues/1760)) ([e9fd76e](https://github.com/folke/lazy.nvim/commit/e9fd76e239cc18da289f9a3f80f35fa16b003175)), closes [#1758](https://github.com/folke/lazy.nvim/issues/1758)
+* **docs:** always update helptags for local plugins ([60cf258](https://github.com/folke/lazy.nvim/commit/60cf258a9ae7fffe04bb31141141a91845158dcc))
+* **luarocks:** try to install from root manifest ([#1687](https://github.com/folke/lazy.nvim/issues/1687)) ([591ef40](https://github.com/folke/lazy.nvim/commit/591ef40f2da3a26fbcc0466988cd6fe45ca68cae))
+* **rocks:** add lib64 plugin directory to package.cpath ([#1717](https://github.com/folke/lazy.nvim/issues/1717)) ([80da254](https://github.com/folke/lazy.nvim/commit/80da254e645f579c28394ee0f08f75a9c9481744))
+* **rockspec:** allow binary lua files. Fixes [#1800](https://github.com/folke/lazy.nvim/issues/1800) ([408449a](https://github.com/folke/lazy.nvim/commit/408449a59adb8c2a31c32fff606676b32ce4552a))
+
 ## [11.14.1](https://github.com/folke/lazy.nvim/compare/v11.14.0...v11.14.1) (2024-07-25)
 
 

bootstrap.lua

@@ -1,4 +1,4 @@
--- Lay Bootstrapper
+-- Lazy Bootstrapper
 -- Usage:
 -- ```lua
 -- load(vim.fn.system("curl -s https://raw.githubusercontent.com/folke/lazy.nvim/main/bootstrap.lua"))()
@@ -6,19 +6,20 @@
 local M = {}
 
 function M.setup()
+  local uv = vim.uv or vim.loop
   if vim.env.LAZY_STDPATH then
-    local root = vim.fn.fnamemodify(vim.env.LAZY_STDPATH, ":p")
+    local root = vim.fn.fnamemodify(vim.env.LAZY_STDPATH, ":p"):gsub("[\\/]$", "")
     for _, name in ipairs({ "config", "data", "state", "cache" }) do
       vim.env[("XDG_%s_HOME"):format(name:upper())] = root .. "/" .. name
     end
   end
 
-  if vim.env.LAZY_PATH and not vim.uv.fs_stat(vim.env.LAZY_PATH) then
+  if vim.env.LAZY_PATH and not uv.fs_stat(vim.env.LAZY_PATH) then
     vim.env.LAZY_PATH = nil
   end
 
   local lazypath = vim.env.LAZY_PATH or vim.fn.stdpath("data") .. "/lazy/lazy.nvim"
-  if not vim.env.LAZY_PATH and not (vim.uv or vim.loop).fs_stat(lazypath) then
+  if not vim.env.LAZY_PATH and not uv.fs_stat(lazypath) then
     vim.api.nvim_echo({
       {
         "Cloning lazy.nvim\n\n",

doc/lazy.nvim.txt

@@ -540,9 +540,7 @@ function.
         keys = {
           { "<leader>ft", "<cmd>Neotree toggle<cr>", desc = "NeoTree" },
         },
-        config = function()
-          require("neo-tree").setup()
-        end,
+        opts = {},
     }
 <
 
@@ -646,24 +644,42 @@ will be added to the plugin’s spec.
         -- then set the below to false. This should work, but is NOT supported and will
         -- increase downloads a lot.
         filter = true,
+        -- rate of network related git operations (clone, fetch, checkout)
+        throttle = {
+          enabled = false, -- not enabled by default
+          -- max 2 ops every 5 seconds
+          rate = 2,
+          duration = 5 * 1000, -- in ms
+        },
+        -- Time in seconds to wait before running fetch again for a plugin.
+        -- Repeated update/check operations will not run again until this
+        -- cooldown period has passed.
+        cooldown = 0,
       },
       pkg = {
         enabled = true,
         cache = vim.fn.stdpath("state") .. "/lazy/pkg-cache.lua",
-        versions = true, -- Honor versions in pkg sources
         -- the first package source that is found for a plugin will be used.
         sources = {
           "lazy",
-          "rockspec",
+          "rockspec", -- will only be used when rocks.enabled is true
           "packspec",
         },
       },
       rocks = {
+        enabled = true,
         root = vim.fn.stdpath("data") .. "/lazy-rocks",
-        server = "https://nvim-neorocks.github.io/rocks-binaries/",
+        server = "https://lumen-oss.github.io/rocks-binaries/",
+        -- use hererocks to install luarocks?
+        -- set to `nil` to use hererocks when luarocks is not found
+        -- set to `true` to always use hererocks
+        -- set to `false` to always use luarocks
+        hererocks = nil,
       },
       dev = {
-        ---@type string | fun(plugin: LazyPlugin): string directory where you store your local plugin projects
+        -- Directory where you store your local plugin projects. If a function is used,
+        -- the plugin directory (e.g. `~/projects/plugin-name`) must be returned.
+        ---@type string | fun(plugin: LazyPlugin): string
         path = "~/projects",
         ---@type string[] plugins that match these patterns will use your local versions instead of being fetched from GitHub
         patterns = {}, -- For example {"folke"}
@@ -690,6 +706,7 @@ will be added to the plugin’s spec.
         icons = {
           cmd = " ",
           config = "",
+          debug = "● ",
           event = " ",
           favorite = " ",
           ft = " ",
@@ -715,7 +732,7 @@ will be added to the plugin’s spec.
         -- leave nil, to automatically select a browser depending on your OS.
         -- If you want to use a specific browser, you can define it here
         browser = nil, ---@type string?
-        throttle = 20, -- how frequently should the ui process render events
+        throttle = 1000 / 30, -- how frequently should the ui process render events
         custom_keys = {
           -- You can define custom key maps here. If present, the description will
           -- be shown in the help menu.
@@ -730,6 +747,16 @@ will be added to the plugin’s spec.
             desc = "Open lazygit log",
           },
     
+          ["<localleader>i"] = {
+            function(plugin)
+              Util.notify(vim.inspect(plugin), {
+                title = "Inspect " .. plugin.name,
+                lang = "lua",
+              })
+            end,
+            desc = "Inspect Plugin",
+          },
+    
           ["<localleader>t"] = {
             function(plugin)
               require("lazy.util").float_term(nil, {
@@ -740,6 +767,17 @@ will be added to the plugin’s spec.
           },
         },
       },
+      -- Output options for headless mode
+      headless = {
+        -- show the output from process commands like git
+        process = true,
+        -- show log messages
+        log = true,
+        -- show task start/end
+        task = true,
+        -- use ansi colors
+        colors = true,
+      },
       diff = {
         -- diff command <d> can be one of:
         -- * browser: opens the github compare view. Note that this is always mapped to <K> as well,
@@ -791,7 +829,7 @@ will be added to the plugin’s spec.
         enabled = true,
         root = vim.fn.stdpath("state") .. "/lazy/readme",
         files = { "README.md", "lua/**/README.md" },
-        -- only generate markdown helptags for plugins that dont have docs
+        -- only generate markdown helptags for plugins that don't have docs
         skip_if_doc_exists = true,
       },
       state = vim.fn.stdpath("state") .. "/lazy/state.json", -- state info for checker and other things
@@ -837,6 +875,8 @@ If you don’t want to use a Nerd Font, you can replace the icons with Unicode s
   -----------------------------------------------------------------------
   Highlight Group         Default Group           Description
   ----------------------- ----------------------- -----------------------
+  LazyBold                { bold = true }         
+
   LazyButton              CursorLine              
 
   LazyButtonActive        Visual                  
@@ -857,10 +897,16 @@ If you don’t want to use a Nerd Font, you can replace the icons with Unicode s
 
   LazyDir                 @markup.link            directory
 
+  LazyError               DiagnosticError         task errors
+
   LazyH1                  IncSearch               home button
 
   LazyH2                  Bold                    titles
 
+  LazyInfo                DiagnosticInfo          task errors
+
+  LazyItalic              { italic = true }       
+
   LazyLocal               Constant                
 
   LazyNoCond              DiagnosticWarn          unloaded icon for a
@@ -897,13 +943,13 @@ If you don’t want to use a Nerd Font, you can replace the icons with Unicode s
 
   LazySpecial             @punctuation.special    
 
-  LazyTaskError           ErrorMsg                task errors
-
   LazyTaskOutput          MsgArea                 task output
 
   LazyUrl                 @markup.link            url
 
   LazyValue               @string                 value of a property
+
+  LazyWarning             DiagnosticWarn          task errors
   -----------------------------------------------------------------------
 
 ==============================================================================

lua/lazy/build.lua

@@ -6,6 +6,7 @@ local Util = require("lazy.util")
 local M = {}
 
 M.patterns = { "nvim", "treesitter", "tree-sitter", "cmp", "neo" }
+local manifest_file = "build/manifest.lua"
 
 function M.fetch(url, file, prefix)
   if not vim.uv.fs_stat(file) then
@@ -19,11 +20,46 @@ function M.fetch(url, file, prefix)
   end
 end
 
+function M.split()
+  local lines = vim.fn.readfile(manifest_file)
+  local id = 0
+  local files = {} ---@type string[]
+  while #lines > 0 do
+    id = id + 1
+    local part_file = "build/manifest-part-" .. id .. ".lua"
+    local idx = math.min(#lines, 30000)
+    while idx < #lines and not lines[idx]:match("^   },$") do
+      idx = idx + 1
+    end
+    local part_lines = vim.list_slice(lines, 1, idx)
+    if idx ~= #lines then
+      part_lines[#part_lines] = "   }}"
+    end
+    vim.fn.writefile(part_lines, part_file)
+    files[#files + 1] = part_file
+    print("Wrote " .. part_file .. "\n")
+
+    lines = vim.list_slice(lines, idx + 1)
+    if #lines == 0 then
+      break
+    end
+    lines[1] = "repository = { " .. lines[1]
+  end
+  return files
+end
+
 ---@return RockManifest?
 function M.fetch_manifest()
-  local manifest_file = "build/manifest.lua"
   M.fetch("https://luarocks.org/manifest-5.1", manifest_file)
-  return Rocks.parse(manifest_file)
+  local ret = { repository = {} }
+  for _, file in ipairs(M.split()) do
+    local part = Rocks.parse(file)
+    print(vim.tbl_count(part.repository or {}) .. " rocks in " .. file .. "\n")
+    for k, v in pairs(part.repository or {}) do
+      ret.repository[k] = v
+    end
+  end
+  return ret
 end
 
 function M.fetch_rockspec(name, version, prefix)
@@ -37,6 +73,7 @@ function M.build()
   local manifest = M.fetch_manifest() or {}
   ---@type {name:string, version:string, url:string}[]
   local nvim_rocks = {}
+  print(vim.tbl_count(manifest.repository or {}) .. " rocks in manifest\n")
   for rock, vv in pairs(manifest.repository or {}) do
     local matches = false
     for _, pattern in ipairs(M.patterns) do

lua/lazy/core/config.lua

@@ -59,7 +59,7 @@ M.defaults = {
   rocks = {
     enabled = true,
     root = vim.fn.stdpath("data") .. "/lazy-rocks",
-    server = "https://nvim-neorocks.github.io/rocks-binaries/",
+    server = "https://lumen-oss.github.io/rocks-binaries/",
     -- use hererocks to install luarocks?
     -- set to `nil` to use hererocks when luarocks is not found
     -- set to `true` to always use hererocks
@@ -67,7 +67,9 @@ M.defaults = {
     hererocks = nil,
   },
   dev = {
-    ---@type string | fun(plugin: LazyPlugin): string directory where you store your local plugin projects
+    -- Directory where you store your local plugin projects. If a function is used,
+    -- the plugin directory (e.g. `~/projects/plugin-name`) must be returned.
+    ---@type string | fun(plugin: LazyPlugin): string
     path = "~/projects",
     ---@type string[] plugins that match these patterns will use your local versions instead of being fetched from GitHub
     patterns = {}, -- For example {"folke"}
@@ -94,6 +96,7 @@ M.defaults = {
     icons = {
       cmd = " ",
       config = "",
+      debug = "● ",
       event = " ",
       favorite = " ",
       ft = " ",
@@ -216,7 +219,7 @@ M.defaults = {
     enabled = true,
     root = vim.fn.stdpath("state") .. "/lazy/readme",
     files = { "README.md", "lua/**/README.md" },
-    -- only generate markdown helptags for plugins that dont have docs
+    -- only generate markdown helptags for plugins that don't have docs
     skip_if_doc_exists = true,
   },
   state = vim.fn.stdpath("state") .. "/lazy/state.json", -- state info for checker and other things
@@ -239,7 +242,7 @@ function M.hererocks()
   return M.options.rocks.hererocks
 end
 
-M.version = "11.14.1" -- x-release-please-version
+M.version = "11.17.5" -- x-release-please-version
 
 M.ns = vim.api.nvim_create_namespace("lazy")
 

lua/lazy/core/handler/keys.lua

@@ -11,7 +11,7 @@ local Util = require("lazy.core.util")
 
 ---@class LazyKeysSpec: LazyKeysBase
 ---@field [1] string lhs
----@field [2]? string|fun()|false rhs
+---@field [2]? string|fun():string?|false rhs
 ---@field mode? string|string[]
 
 ---@class LazyKeys: LazyKeysBase

lua/lazy/core/loader.lua

@@ -341,7 +341,9 @@ function M._load(plugin, reason, opts)
   Util.track({ plugin = plugin.name, start = reason.start })
   Handler.disable(plugin)
 
-  M.add_to_rtp(plugin)
+  if not plugin.virtual then
+    M.add_to_rtp(plugin)
+  end
 
   if plugin._.pkg and plugin._.pkg.source == "rockspec" then
     M.add_to_luapath(plugin)
@@ -353,7 +355,9 @@ function M._load(plugin, reason, opts)
     end, "Failed to load deps for " .. plugin.name)
   end
 
-  M.packadd(plugin.dir)
+  if not plugin.virtual then
+    M.packadd(plugin.dir)
+  end
   if plugin.config or plugin.opts then
     M.config(plugin)
   end
@@ -493,8 +497,11 @@ function M.add_to_luapath(plugin)
   local root = Config.options.rocks.root .. "/" .. plugin.name
   local path = root .. "/share/lua/5.1"
   local cpath = root .. "/lib/lua/5.1"
+  local cpath2 = root .. "/lib64/lua/5.1"
+
   package.path = package.path .. ";" .. path .. "/?.lua;" .. path .. "/?/init.lua;"
   package.cpath = package.cpath .. ";" .. cpath .. "/?." .. (jit.os:find("Windows") and "dll" or "so") .. ";"
+  package.cpath = package.cpath .. ";" .. cpath2 .. "/?." .. (jit.os:find("Windows") and "dll" or "so") .. ";"
 end
 
 function M.source(path)

lua/lazy/core/meta.lua

@@ -179,6 +179,7 @@ function M:_rebuild(name)
   local super = nil
   plugin.url = nil
   plugin._.dep = true
+  plugin._.top = true
   plugin.optional = true
 
   assert(#plugin._.frags > 0, "no fragments found for plugin " .. name)
@@ -195,6 +196,7 @@ function M:_rebuild(name)
       plugin._.dep = plugin._.dep and fragment.dep
       plugin.optional = plugin.optional and (rawget(fragment.spec, "optional") == true)
       plugin.url = fragment.url or plugin.url
+      plugin._.top = plugin._.top and fragment.pid == nil
 
       -- dependencies
       for _, dep in ipairs(fragment.deps or {}) do
@@ -213,6 +215,8 @@ function M:_rebuild(name)
   plugin.dir = super.dir
   if plugin.dir then
     plugin.dir = Util.norm(plugin.dir)
+  elseif super.virtual then
+    plugin.dir = Util.norm("/dev/null/" .. plugin.name)
   else
     if plugin.dev == nil and plugin.url then
       for _, pattern in ipairs(Config.options.dev.patterns) do
@@ -300,13 +304,26 @@ end
 --- Removes plugins that are disabled.
 function M:fix_disabled()
   local changes = 0
-  for _, plugin in pairs(self.plugins) do
-    if plugin.enabled == false or (type(plugin.enabled) == "function" and not plugin.enabled()) then
-      changes = changes + 1
-      self:disable(plugin)
+  local function check(top)
+    for _, plugin in pairs(self.plugins) do
+      if (plugin._.top or false) == top then
+        if plugin.enabled == false or (type(plugin.enabled) == "function" and not plugin.enabled()) then
+          changes = changes + 1
+          if plugin.optional then
+            self:del(plugin.name)
+          else
+            self:disable(plugin)
+          end
+          self:rebuild()
+        end
+      end
     end
   end
-  self:rebuild()
+  -- disable top-level plugins first, since they may have non-top-level frags
+  -- that disable other plugins
+  check(true)
+  -- then disable non-top-level plugins
+  check(false)
   return changes
 end
 

lua/lazy/core/plugin.lua

@@ -156,7 +156,11 @@ function Spec:import(spec)
         load = function()
           local mod, err = loadfile(modpath)
           if mod then
-            return mod()
+            local ret, foo = mod()
+            if foo then
+              return nil, "Spec module returned more than one value. Expected a single value."
+            end
+            return ret
           else
             return nil, err
           end
@@ -237,12 +241,15 @@ function M.update_state()
         or plugin.cmd
       plugin.lazy = lazy and true or false
     end
-    if plugin.dir:find(Config.options.root, 1, true) == 1 then
+    if plugin.virtual then
+      plugin._.is_local = true
+      plugin._.installed = true -- local plugins are managed by the user
+    elseif plugin.dir:find(Config.options.root .. "/", 1, true) == 1 then
       plugin._.installed = installed[plugin.name] ~= nil
       installed[plugin.name] = nil
     else
       plugin._.is_local = true
-      plugin._.installed = true -- local plugins are managed by the user
+      plugin._.installed = vim.fn.isdirectory(plugin.dir) == 1
     end
   end
 

lua/lazy/core/util.lua

@@ -270,7 +270,7 @@ function M.get_unloaded_rtp(modname, opts)
   local Config = require("lazy.core.config")
   if Config.spec then
     for _, plugin in pairs(Config.spec.plugins) do
-      if not (plugin._.loaded or plugin.module == false) then
+      if not (plugin._.loaded or plugin.module == false or plugin.virtual) then
         if norm == M.normname(plugin.name) then
           table.insert(rtp, 1, plugin.dir)
         else
@@ -374,6 +374,7 @@ function M.notify(msg, opts)
   local lang = opts.lang or "markdown"
   local n = opts.once and vim.notify_once or vim.notify
   n(msg, opts.level or vim.log.levels.INFO, {
+    ft = lang,
     on_open = function(win)
       local ok = pcall(function()
         vim.treesitter.language.add("markdown")

lua/lazy/docs.lua

@@ -61,7 +61,11 @@ end
 ---@return string
 function M.extract(file, pattern)
   local init = Util.read_file(file)
-  return assert(init:match(pattern))
+  local ret = assert(init:match(pattern)) --[[@as string]]
+  local lines = vim.tbl_filter(function(line)
+    return not line:find("^%s*%-%-%s*stylua%s*:%s*ignore%s*$")
+  end, vim.split(ret, "\n"))
+  return table.concat(lines, "\n")
 end
 
 ---@return ReadmeBlock
@@ -131,7 +135,8 @@ function M.colors(opts)
     { "---", "---", "---" },
   }
   Util.foreach(require(opts.modname).colors, function(group, link)
-    lines[#lines + 1] = { "**" .. opts.name .. group .. "**", "***" .. link .. "***", comments[group] or "" }
+    link = type(link) == "table" and "`" .. vim.inspect(link):gsub("%s+", " ") .. "`" or "***" .. link .. "***"
+    lines[#lines + 1] = { "**" .. opts.name .. group .. "**", link, comments[group] or "" }
   end)
   return { content = M.table(lines) }
 end

lua/lazy/manage/init.lua

@@ -80,6 +80,7 @@ function M.install(opts)
   opts = M.opts(opts, { mode = "install" })
   return M.run({
     pipeline = {
+      "plugin.exists",
       "git.clone",
       { "git.checkout", lockfile = opts.lockfile },
       "plugin.docs",
@@ -108,6 +109,7 @@ function M.update(opts)
   opts = M.opts(opts, { mode = "update" })
   return M.run({
     pipeline = {
+      "plugin.exists",
       "git.origin",
       "git.branch",
       "git.fetch",
@@ -147,6 +149,7 @@ function M.check(opts)
   opts = opts or {}
   return M.run({
     pipeline = {
+      "plugin.exists",
       { "git.origin", check = true },
       "git.fetch",
       "git.status",

lua/lazy/manage/task/fs.lua

@@ -25,7 +25,7 @@ M.clean = {
   run = function(self, opts)
     opts = opts or {}
     local dir = self.plugin.dir:gsub("/+$", "")
-    assert(dir:find(Config.options.root, 1, true) == 1, self.plugin.dir .. " should be under packpath!")
+    assert(dir:find(Config.options.root .. "/", 1, true) == 1, self.plugin.dir .. " should be under packpath!")
 
     local rock_root = Config.options.rocks.root .. "/" .. self.plugin.name
     if vim.uv.fs_stat(rock_root) then

lua/lazy/manage/task/git.lua

@@ -335,7 +335,7 @@ M.checkout = {
       end
     end
 
-    -- dont run checkout if target is already reached.
+    -- don't run checkout if target is already reached.
     -- unless we just cloned, since then we won't have any data yet
     if Git.eq(info, target) and info.branch == target.branch then
       self.plugin._.updated = {

lua/lazy/manage/task/plugin.lua

@@ -87,7 +87,7 @@ M.build = {
 
 M.docs = {
   skip = function(plugin)
-    return not plugin._.dirty
+    return not plugin._.is_local and not plugin._.dirty
   end,
   run = function(self)
     local docs = self.plugin.dir .. "/doc"
@@ -97,4 +97,15 @@ M.docs = {
   end,
 }
 
+M.exists = {
+  skip = function(plugin)
+    return not plugin._.is_local or plugin.virtual
+  end,
+  run = function(self)
+    if not Util.file_exists(self.plugin.dir) then
+      self:error("Local plugin does not exist at `" .. self.plugin.dir .. "`")
+    end
+  end,
+}
+
 return M

lua/lazy/minit.lua

@@ -33,11 +33,14 @@ function M.setup(opts)
   local args = {}
   local is_busted = false
   local is_minitest = false
+  local offline = vim.env.LAZY_OFFLINE == "1" or vim.env.LAZY_OFFLINE == "true"
   for _, a in ipairs(_G.arg) do
     if a == "--busted" then
       is_busted = true
     elseif a == "--minitest" then
       is_minitest = true
+    elseif a == "--offline" then
+      offline = true
     else
       table.insert(args, a)
     end
@@ -62,7 +65,9 @@ function M.setup(opts)
   if vim.g.colors_name == nil then
     vim.cmd("colorscheme habamax")
   end
-  require("lazy").update():wait()
+  if not offline then
+    require("lazy").update():wait()
+  end
   if vim.bo.filetype == "lazy" then
     local errors = false
     for _, plugin in pairs(require("lazy.core.config").spec.plugins) do
@@ -150,7 +155,7 @@ function M.minitest.setup(opts)
         opts = {
           collect = {
             find_files = function()
-              return vim.fn.globpath("tests", "**/*_spec.lua", true, true)
+              return #_G.arg > 0 and _G.arg or vim.fn.globpath("tests", "**/*_spec.lua", true, true)
             end,
           },
           -- script_path = "tests/minit.lua",

lua/lazy/pkg/init.lua

@@ -63,6 +63,9 @@ function M.update()
             pkg.spec = { _raw = spec.code }
           end
           table.insert(ret.pkgs, pkg)
+          if not plugin._.pkg and plugin._.loaded and pkg.source == "rockspec" then
+            require("lazy.core.loader").add_to_luapath(plugin)
+          end
           break
         end
       end

lua/lazy/pkg/rockspec.lua

@@ -172,7 +172,6 @@ function M.build(task)
       root,
       "--server",
       Config.options.rocks.server,
-      "--dev",
       "--lua-version",
       "5.1",
       "install", -- use install so that we can make use of pre-built rocks
@@ -225,9 +224,10 @@ end
 ---@return table?
 function M.parse(file)
   local ret = {}
-  return pcall(function()
-    loadfile(file, "t", ret)()
+  local ok = pcall(function()
+    loadfile(file, nil, ret)()
   end) and ret or nil
+  return ok and ret or nil
 end
 
 ---@param plugin LazyPlugin
@@ -285,7 +285,10 @@ function M.get(plugin)
 
   ---@param dep string
   local rocks = vim.tbl_filter(function(dep)
-    local name = dep:gsub("%s.*", "")
+    local name = dep:match("^%s*([^~><=%s]+)")
+    if not name then
+      return false
+    end
     local url = Community.get_url(name)
     local spec = Community.get_spec(name)
 

lua/lazy/stats.lua

@@ -35,11 +35,10 @@ function M.cputime()
   if M.C == nil then
     pcall(function()
       ffi.cdef([[
-        typedef long time_t;
         typedef int clockid_t;
         typedef struct timespec {
-          time_t   tv_sec;        /* seconds */
-          long     tv_nsec;       /* nanoseconds */
+          int64_t tv_sec;   /* Use fixed 64-bit type for portability */
+          long    tv_nsec;  /* nanoseconds */
         } nanotime;
         int clock_gettime(clockid_t clk_id, struct timespec *tp);
       ]])
@@ -48,7 +47,8 @@ function M.cputime()
   end
 
   local function real()
-    local pnano = assert(ffi.new("nanotime[?]", 1))
+    -- Zero-initialize to handle 32-bit systems where only lower 32 bits are written
+    local pnano = ffi.new("nanotime[1]")
     local CLOCK_PROCESS_CPUTIME_ID = jit.os == "OSX" and 12 or 2
     ffi.C.clock_gettime(CLOCK_PROCESS_CPUTIME_ID, pnano)
     return tonumber(pnano[0].tv_sec) * 1e3 + tonumber(pnano[0].tv_nsec) / 1e6

lua/lazy/types.lua

@@ -10,6 +10,7 @@
 ---@field dirty? boolean
 ---@field build? boolean
 ---@field frags? number[]
+---@field top? boolean
 ---@field handlers? LazyPluginHandlers
 ---@field installed? boolean
 ---@field is_local? boolean
@@ -60,6 +61,7 @@
 ---@field priority? number Only useful for lazy=false plugins to force loading certain plugins first. Default priority is 50
 ---@field dev? boolean If set, then link to the respective folder under your ~/projects
 ---@field rocks? string[]
+---@field virtual? boolean virtual plugins won't be installed or added to the rtp.
 
 ---@class LazyPlugin: LazyPluginBase,LazyPluginHandlers,LazyPluginHooks,LazyPluginRef
 ---@field dependencies? string[]
@@ -74,6 +76,8 @@
 ---@field module? false
 
 ---@class LazyPluginSpec: LazyPluginBase,LazyPluginSpecHandlers,LazyPluginHooks,LazyPluginRef
+---@field name? string display name and name used for plugin config files
+---@field dir? string
 ---@field dependencies? string|string[]|LazyPluginSpec[]
 ---@field specs? string|string[]|LazyPluginSpec[]
 

lua/lazy/view/commands.lua

@@ -146,7 +146,7 @@ end
 ---@return string, string[]
 function M.parse(args)
   local parts = vim.split(vim.trim(args), "%s+")
-  if parts[1]:find("Lazy") then
+  if vim.startswith("Lazy", parts[1]) then
     table.remove(parts, 1)
   end
   if args:sub(-1) == " " then

lua/lazy/view/render.lua

@@ -94,7 +94,7 @@ function M:update()
       diag.lnum = diag.row - 1
       return diag
     end, self._diagnostics),
-    { signs = false, virtual_text = true, underline = false }
+    { signs = false, virtual_text = true, underline = false, virtual_lines = false }
   )
 end
 
@@ -144,8 +144,6 @@ function M:title()
       if mode.name == "home" then
         if self.view.state.mode == "home" then
           title = " lazy.nvim " .. Config.options.ui.icons.lazy
-        else
-          title = " lazy.nvim (H) "
         end
       end
 
@@ -761,7 +759,7 @@ function M:debug()
         ---@type string[]
         plugins = vim.tbl_values(plugins)
         table.sort(plugins)
-        self:append("● ", "LazySpecial", { indent = 2 })
+        self:append(Config.options.ui.icons.debug, "LazySpecial", { indent = 2 })
         if handler_type == "keys" then
           for k, v in pairs(Config.plugins[plugins[1]]._.handlers.keys) do
             if k == value then

scripts/test

@@ -1,3 +1,3 @@
-#!/bin/env bash
+#!/usr/bin/env bash
 
-nvim -l tests/minit.lua --minitest
+nvim -l tests/minit.lua --minitest "$@"

tests/core/plugin_spec.lua

@@ -25,6 +25,7 @@ local function clean(plugins)
     if plugin._.dep == false then
       plugin._.dep = nil
     end
+    plugin._.top = nil
     return plugin
   end, plugins)
 end

vim.toml

@@ -1,21 +0,0 @@
-[selene]
-base = "lua51"
-name = "vim"
-
-[vim]
-any = true
-
-[jit]
-any = true
-
-[assert]
-any = true
-
-[describe]
-any = true
-
-[it]
-any = true
-
-[before_each.args]
-any = true

vim.yml

@@ -0,0 +1,19 @@
+base: lua51
+lua_versions:
+  - luajit
+
+globals:
+  Snacks:
+    any: true
+  vim:
+    any: true
+  jit:
+    any: true
+  assert:
+    any: true
+  describe:
+    any: true
+  it:
+    any: true
+  before_each:
+    any: true