feat(mappings): allow flagging a mapping as real. It will be hidden if there's no real keymap.

Author: folke

lua/which-key/mappings.lua

@@ -46,6 +46,7 @@ M.fields = {
   cond = { inherit = true },
   preset = { inherit = true },
   icon = { inherit = true },
+  real = { inherit = true },
   proxy = {},
   expand = {},
   -- deprecated

lua/which-key/tree.lua

@@ -63,6 +63,9 @@ function M:keep(node)
   if node.hidden or (node.keymap and node.keymap.desc == "which_key_ignore") then
     return false
   end
+  if node.mapping and node.mapping.real and not node.keymap then
+    return false
+  end
   return node.keymap or (node.mapping and not node.group) or node:is_group()
 end
 

lua/which-key/types.lua

@@ -55,6 +55,7 @@
 ---@field group? boolean
 ---@field remap? boolean
 ---@field hidden? boolean
+---@field real? boolean this is a mapping for a real keymap. Hide it if the real keymap does not exist
 ---@field preset? boolean
 ---@field icon? wk.Icon|string
 ---@field proxy? string