fix(picker.git_branches): handle detached HEAD

[kyon45]

Description

Handle detached HEAD

• list: display correct information
• preview: without error notification
• action: checkout the commit that HEAD detached at

Related Issue(s)

• Fixes bug(picker.git_branches): Detached HEAD breaks down the previewer #672

Screenshots

Before:

After:

[folke]

Great! Made some small improvements:

[folke]

ty!

[kyon45]

@folke Found another edge case: HEAD detached at {tag} 😂

$ git checkout v2.14.0
$ git --no-pager branch --no-color -vvl            
* (HEAD detached at v2.14.0) 8d820a6 chore(main): release 2.14.0 (#646)
  main                       233356e [origin/main] chore(build): auto-generate docs

Can be fixed by extending the pattern_hash regex pattern

diff --git a/lua/snacks/picker/source/git.lua b/lua/snacks/picker/source/git.lua
index 4f489ea..d05fec7 100644
--- a/lua/snacks/picker/source/git.lua
+++ b/lua/snacks/picker/source/git.lua
@@ -164,11 +164,12 @@ function M.branches(opts)
   local cwd = vim.fs.normalize(opts and opts.cwd or uv.cwd() or ".") or nil
   cwd = Snacks.git.get_root(cwd)
 
+  local pattern_detached_at = "[a-zA-Z0-9.v]+" -- tag or commit hash
   local pattern_hash = "[a-zA-Z0-9]+"
   local patterns = {
     -- stylua: ignore start
     --- e.g. "* (HEAD detached at f65a2c8) f65a2c8 chore(build): auto-generate docs"
-    "^(.)%s(%(HEAD detached at " .. pattern_hash .. "%))%s+(" .. pattern_hash .. ")%s*(.*)$",
+    "^(.)%s(%(HEAD detached at " .. pattern_detached_at .. "%))%s+(" .. pattern_hash .. ")%s*(.*)$",
     --- e.g. "  main                       d2b2b7b [origin/main: behind 276] chore(build): auto-generate docs"
     "^(.)%s(%S+)%s+(".. pattern_hash .. ")%s*(.*)$",
     -- stylua: ignore end

However, {tag} may vary in different projects, maybe we can allow user to pass an opts.tag_pattern to customize it.

[folke]

Changed it so it can parse all special states