feat(clue)!: show clue of current query as window title

Details:
- This shows current context and helps navigating through mappings.
  Should improve experience for new MiniMax users.

Author: echasnovski

CHANGELOG.md

@@ -77,6 +77,10 @@ There are following change types:
 
 ## mini.clue
 
+### Evolve
+
+- Use current query clue (if not immediately after trigger) as a window title instead of showing keys verbatim. This shows extra context when navigating through mappings.
+
 ### Expand
 
 - Add `gen_clues.square_brackets` to generate clues for `[` and `]` keys. By @TheLeoP, PR #1937.

lua/mini/clue.lua

@@ -1679,12 +1679,16 @@ H.window_get_config = function()
   local max_height = vim.o.lines - vim.o.cmdheight - (has_tabline and 1 or 0) - (has_statusline and 1 or 0) - 2
   max_height = math.max(max_height, 1)
 
+  local keys = H.query_to_keys(H.state.query)
+  local query_clue = (H.state.clues[keys] or {}).desc or ''
+  local title = (#H.state.query <= 1 or query_clue == '') and H.keytrans(keys) or query_clue
+
   local buf_id = H.state.buf_id
   local cur_config_fields = {
     row = vim.o.lines - vim.o.cmdheight - (has_statusline and 1 or 0),
     col = vim.o.columns,
     height = math.min(vim.api.nvim_buf_line_count(buf_id), max_height),
-    title = ' ' .. H.keytrans(H.query_to_keys(H.state.query)) .. ' ',
+    title = ' ' .. title .. ' ',
     border = (vim.fn.exists('+winborder') == 1 and vim.o.winborder ~= '') and vim.o.winborder or 'single',
   }
   local user_config = H.expand_callable(H.get_config().window.config, buf_id) or {}

tests/screenshots/tests-test_clue.lua---Clues---handles-showing-group-clues-after-executing-key-with-postkeys-002

@@ -3,7 +3,7 @@
 02|~                                       
 03|~                                       
 04|~                                       
-05|~       ┌ <Space>g ────────────────────┐
+05|~       ┌ Group ───────────────────────┐
 06|~       │ a │ LHS: " ga"               │
 07|~       │ b │ LHS: " gb"               │
 08|~       └──────────────────────────────┘
@@ -15,7 +15,7 @@
 02|1111111111111111111111111111111111111111
 03|1111111111111111111111111111111111111111
 04|1111111111111111111111111111111111111111
-05|1111111123333333333222222222222222222222
+05|1111111123333333222222222222222222222222
 06|1111111124445666666666666666666666666662
 07|1111111124445666666666666666666666666662
 08|1111111122222222222222222222222222222222

tests/screenshots/tests-test_clue.lua---Showing-keys---uses-query-clue-as-title

@@ -0,0 +1,23 @@
+--|---------|---------|---------|
+01|                              
+02|~                             
+03|~                             
+04|~       ┌ <Space> ───────────┐
+05|~       │ a │ Group a        │
+06|~       │ b │ +3 choices     │
+07|~       │ c │ +1 choice      │
+08|~       └────────────────────┘
+09|[No Name] 0,0-1               
+10|                              
+
+--|---------|---------|---------|
+01|000000000000000000000000000000
+02|111111111111111111111111111111
+03|111111111111111111111111111111
+04|111111112333333333222222222222
+05|111111112444566666666666666662
+06|111111112444566666666666666662
+07|111111112444577777777777777772
+08|111111112222222222222222222222
+09|888888888888888888888888888888
+10|999999999999999999999999999999

tests/screenshots/tests-test_clue.lua---Showing-keys---uses-query-clue-as-title-002

@@ -0,0 +1,23 @@
+--|---------|---------|---------|
+01|                              
+02|~                             
+03|~                             
+04|~                             
+05|~                             
+06|~       ┌ Group a ───────────┐
+07|~       │ a │ Subgroup aa    │
+08|~       └────────────────────┘
+09|[No Name] 0,0-1               
+10|                              
+
+--|---------|---------|---------|
+01|000000000000000000000000000000
+02|111111111111111111111111111111
+03|111111111111111111111111111111
+04|111111111111111111111111111111
+05|111111111111111111111111111111
+06|111111112333333333222222222222
+07|111111112444566666666666666662
+08|111111112222222222222222222222
+09|777777777777777777777777777777
+10|888888888888888888888888888888

tests/screenshots/tests-test_clue.lua---Showing-keys---uses-query-clue-as-title-003

@@ -0,0 +1,23 @@
+--|---------|---------|---------|
+01|                              
+02|~                             
+03|~                             
+04|~                             
+05|~       ┌ Subgroup aa ───────┐
+06|~       │ a │ Do aaa         │
+07|~       │ b │ Do aab         │
+08|~       └────────────────────┘
+09|[No Name] 0,0-1               
+10|                              
+
+--|---------|---------|---------|
+01|000000000000000000000000000000
+02|111111111111111111111111111111
+03|111111111111111111111111111111
+04|111111111111111111111111111111
+05|111111112333333333333322222222
+06|111111112444566666666666666662
+07|111111112444566666666666666662
+08|111111112222222222222222222222
+09|777777777777777777777777777777
+10|888888888888888888888888888888

tests/screenshots/tests-test_clue.lua---Showing-keys---uses-query-clue-as-title-004

@@ -0,0 +1,23 @@
+--|---------|---------|---------|
+01|                              
+02|~                             
+03|~                             
+04|~                             
+05|~                             
+06|~       ┌ Group a ───────────┐
+07|~       │ a │ Subgroup aa    │
+08|~       └────────────────────┘
+09|[No Name] 0,0-1               
+10|                              
+
+--|---------|---------|---------|
+01|000000000000000000000000000000
+02|111111111111111111111111111111
+03|111111111111111111111111111111
+04|111111111111111111111111111111
+05|111111111111111111111111111111
+06|111111112333333333222222222222
+07|111111112444566666666666666662
+08|111111112222222222222222222222
+09|777777777777777777777777777777
+10|888888888888888888888888888888

tests/screenshots/tests-test_clue.lua---Showing-keys---uses-query-clue-as-title-005

@@ -0,0 +1,23 @@
+--|---------|---------|---------|
+01|                              
+02|~                             
+03|~                             
+04|~                             
+05|~                             
+06|~       ┌ <Space>b ──────────┐
+07|~       │ a │ Subgroup ba    │
+08|~       └────────────────────┘
+09|[No Name] 0,0-1               
+10|                              
+
+--|---------|---------|---------|
+01|000000000000000000000000000000
+02|111111111111111111111111111111
+03|111111111111111111111111111111
+04|111111111111111111111111111111
+05|111111111111111111111111111111
+06|111111112333333333322222222222
+07|111111112444566666666666666662
+08|111111112222222222222222222222
+09|777777777777777777777777777777
+10|888888888888888888888888888888

tests/screenshots/tests-test_clue.lua---Showing-keys---uses-query-clue-as-title-006

@@ -0,0 +1,23 @@
+--|---------|---------|---------|
+01|                              
+02|~                             
+03|~                             
+04|~                             
+05|~       ┌ Subgroup ba ───────┐
+06|~       │ a │ Do baa         │
+07|~       │ b │ Do bab         │
+08|~       └────────────────────┘
+09|[No Name] 0,0-1               
+10|                              
+
+--|---------|---------|---------|
+01|000000000000000000000000000000
+02|111111111111111111111111111111
+03|111111111111111111111111111111
+04|111111111111111111111111111111
+05|111111112333333333333322222222
+06|111111112444566666666666666662
+07|111111112444566666666666666662
+08|111111112222222222222222222222
+09|777777777777777777777777777777
+10|888888888888888888888888888888

tests/screenshots/tests-test_clue.lua---Showing-keys---uses-query-clue-as-title-007

@@ -0,0 +1,23 @@
+--|---------|---------|---------|
+01|                              
+02|~                             
+03|~                             
+04|~                             
+05|~                             
+06|~       ┌ <Space>c ──────────┐
+07|~       │ a │ +1 choice      │
+08|~       └────────────────────┘
+09|[No Name] 0,0-1               
+10|                              
+
+--|---------|---------|---------|
+01|000000000000000000000000000000
+02|111111111111111111111111111111
+03|111111111111111111111111111111
+04|111111111111111111111111111111
+05|111111111111111111111111111111
+06|111111112333333333322222222222
+07|111111112444566666666666666662
+08|111111112222222222222222222222
+09|777777777777777777777777777777
+10|888888888888888888888888888888