feat(commands): quick jump

[stupidbullet]

Command quick_jump can dynamically compute, assign and render hotkeys for jumping to a specific node, while also monitoring key inputs to handle jump/toggle/cancel actions.

A default leader key for this function ; has been added in defaults.lua now, but no description has been written in doc.

When neo-tree is focused, pressing ; re-renders all icons and displays maps that can be used to jump to/toggle nodes.

Besides, it is possible to bind this action to a global hotkey, for example:

    local manager = require("neo-tree.sources.manager")
    local commands = require("neo-tree.sources.common.commands")

    for _, win in ipairs(vim.api.nvim_tabpage_list_wins(0)) do
      local state = manager.get_state_for_window(win)
      if state and state.tree then
        vim.api.nvim_set_current_win(win)
        commands.quick_jump(state)
        return
      end
    end

This searches for neo-tree window, focuses it, then triggers the function.
It may be helpful to embed it as actions (like focus, show).

[pynappo]

Cool idea. not totally sure if it has to be in neo-tree but will suggest improvements nonetheless

[stupidbullet]

Thanks a lot for your helpful advice, especially for someone new to plugin development :-)

I had barely considered customizability, but this part has been added into the code in the newest commit.

Now it is possible to write different post-jump callback for each sources, as well as jump labels.
However, I decided to keep the builtin open-or-toggle node function, it was my original intention for writing this feature.
Besides, perhaps it is the key to distinguishing the built-in jump from other jump plugins. Of course, we can also use a slightly more complex function to implement the same callback with other plugins (as long as they support it), but having a slightly more advanced built-in advanced function might be a reason people choose to use it.

Rendering is also a point. Most jump plugins attends to overlap its hotkeys among the original word, and it is sometimes inconvenient that I cannot read the filename. Replacing the icon was easily implemented internally, and it perfectly solved this problem.

[stupidbullet]

Also, hotkeys will no longer be exhausted now.

[pynappo]

These seem too highly specific to belong to utils. I would keep all of these functions in sources/common/commands.lua or somewhere like sources/common/lib/jump.lua if you want a separate file

[stupidbullet]

Perhaps a separate file is better, as commands is long enough now and these helpers also are not used anywhere else.