chore(build): auto-generate docs

Author: github-actions[bot]

docs/configuration/general.md

@@ -293,8 +293,21 @@ map("n", "<leader>l", "<cmd>Lazy<cr>", { desc = "Lazy" })
 -- new file
 map("n", "<leader>fn", "<cmd>enew<cr>", { desc = "New File" })
 
-map("n", "<leader>xl", "<cmd>lopen<cr>", { desc = "Location List" })
-map("n", "<leader>xq", "<cmd>copen<cr>", { desc = "Quickfix List" })
+-- location list
+map("n", "<leader>xl", function()
+  local success, err = pcall(vim.fn.getloclist(0, { winid = 0 }).winid ~= 0 and vim.cmd.lclose or vim.cmd.lopen)
+  if not success and err then
+    vim.notify(err, vim.log.levels.ERROR)
+  end
+end, { desc = "Location List" })
+
+-- quickfix list
+map("n", "<leader>xq", function()
+  local success, err = pcall(vim.fn.getqflist({ winid = 0 }).winid ~= 0 and vim.cmd.cclose or vim.cmd.copen)
+  if not success and err then
+    vim.notify(err, vim.log.levels.ERROR)
+  end
+end, { desc = "Quickfix List" })
 
 map("n", "[q", vim.cmd.cprev, { desc = "Previous Quickfix" })
 map("n", "]q", vim.cmd.cnext, { desc = "Next Quickfix" })

docs/extras/editor/snacks_picker.md

@@ -428,6 +428,145 @@ opts = nil
 
 </Tabs>
 
+## [alpha-nvim](https://github.com/goolord/alpha-nvim) _(optional)_
+
+<Tabs>
+
+<TabItem value="opts" label="Options">
+
+```lua
+opts = function(_, dashboard)
+  local button = dashboard.button("p", " " .. " Projects", [[<cmd> lua Snacks.picker.projects() <cr>]])
+  button.opts.hl = "AlphaButtons"
+  button.opts.hl_shortcut = "AlphaShortcut"
+  table.insert(dashboard.section.buttons.val, 4, button)
+end
+```
+
+</TabItem>
+
+
+<TabItem value="code" label="Full Spec">
+
+```lua
+{
+  "goolord/alpha-nvim",
+  optional = true,
+  opts = function(_, dashboard)
+    local button = dashboard.button("p", " " .. " Projects", [[<cmd> lua Snacks.picker.projects() <cr>]])
+    button.opts.hl = "AlphaButtons"
+    button.opts.hl_shortcut = "AlphaShortcut"
+    table.insert(dashboard.section.buttons.val, 4, button)
+  end,
+}
+```
+
+</TabItem>
+
+</Tabs>
+
+## [mini.starter](https://github.com/echasnovski/mini.starter) _(optional)_
+
+<Tabs>
+
+<TabItem value="opts" label="Options">
+
+```lua
+opts = function(_, opts)
+  local items = {
+    {
+      name = "Projects",
+      action = [[lua Snacks.picker.projects()]],
+      section = string.rep(" ", 22) .. "Telescope",
+    },
+  }
+  vim.list_extend(opts.items, items)
+end
+```
+
+</TabItem>
+
+
+<TabItem value="code" label="Full Spec">
+
+```lua
+{
+  "echasnovski/mini.starter",
+  optional = true,
+  opts = function(_, opts)
+    local items = {
+      {
+        name = "Projects",
+        action = [[lua Snacks.picker.projects()]],
+        section = string.rep(" ", 22) .. "Telescope",
+      },
+    }
+    vim.list_extend(opts.items, items)
+  end,
+}
+```
+
+</TabItem>
+
+</Tabs>
+
+## [dashboard-nvim](https://github.com/nvimdev/dashboard-nvim) _(optional)_
+
+<Tabs>
+
+<TabItem value="opts" label="Options">
+
+```lua
+opts = function(_, opts)
+  if not vim.tbl_get(opts, "config", "center") then
+    return
+  end
+  local projects = {
+    action = "lua Snacks.picker.projects()",
+    desc = " Projects",
+    icon = " ",
+    key = "p",
+  }
+
+  projects.desc = projects.desc .. string.rep(" ", 43 - #projects.desc)
+  projects.key_format = "  %s"
+
+  table.insert(opts.config.center, 3, projects)
+end
+```
+
+</TabItem>
+
+
+<TabItem value="code" label="Full Spec">
+
+```lua
+{
+  "nvimdev/dashboard-nvim",
+  optional = true,
+  opts = function(_, opts)
+    if not vim.tbl_get(opts, "config", "center") then
+      return
+    end
+    local projects = {
+      action = "lua Snacks.picker.projects()",
+      desc = " Projects",
+      icon = " ",
+      key = "p",
+    }
+
+    projects.desc = projects.desc .. string.rep(" ", 43 - #projects.desc)
+    projects.key_format = "  %s"
+
+    table.insert(opts.config.center, 3, projects)
+  end,
+}
+```
+
+</TabItem>
+
+</Tabs>
+
 ## [flash.nvim](https://github.com/folke/flash.nvim) _(optional)_
 
 <Tabs>