Questions about the new keymap spec

[augustocdias]

While I understand the appeal and the reasoning to use a closer spec to the internal nvim api, I personally prefer the old way of specifying keymaps for which-key. I see the v3 still supports the old version with a deprecation warning. When will effectively remove the support for the old version? Do you have this planned? I'm trying to find time to migrate them all.

All my which-key keymaps would fit the internal nvim api (except the parent group ones). Would there be any tradeoff between defining them with which-key api in comparison to nvim api? Is it possible to define the group parents with the nvim api?

Would it be possible to create a tree of maps? For example:

• <leader>l -> LSP
  • <leader>lr -> Rust
    • <leader>lra -> Rust Hover Actions
  • <leader>ll -> Lua
    • <leader>lld -> Lua Definitions

And lastly. I can't express how grateful I am for your hard work in creating such a rich ecosystem of plugins. Great work. Thank you very much.

[folke]

The old way will be removed at some point and I'm not going to bring nested mappings back.

To define groups with the Neovim API, add an rhs of "" or "<nop>"

[gsinclair]

If you don't mind, @folke, could you please give a rationale for the deprecation of nested mappings? It seemed quite an elegant design to me, and I don't understand why they are going away. I have looked for a rationale in the docs and the git history but haven't found one.

[augustocdias]

It is to make the api closer to the native neovim api to set keymaps. If you check it is basically the same parameters to add a keymap to which-key and to set via native api. If you're not using any of the features from which-key such as adding icons, you can set all the keymaps with the native api and which-key will work normally as well. This for new users is huge, as they don't have to setup any keymap and which-key will work out of the box.

[folke]

Yes, exactly as @augustocdias says.
The syntax is also pretty much the same as keys for lazy.nvim.