docs(#2994): update help for visual selection ops

- Fix help-defaults.sh to handle non-normal mode keymaps
- Generate help for visual mode API and default keymaps

Author: v3ceban

doc/nvim-tree-lua.txt

@@ -165,6 +165,12 @@ Show the mappings:  `g?`
 `Y`               Copy Relative Path         |nvim_tree.api.fs.copy.relative_path()|
 `<2-LeftMouse>`   Open                       |nvim_tree.api.node.open.edit()|
 `<2-RightMouse>`  CD                         |nvim_tree.api.tree.change_root_to_node()|
+                                             
+`m`               Toggle Bookmark            |nvim_tree.api.marks.toggle_visual()|
+`d`               Delete                     |nvim_tree.api.fs.remove_visual()|
+`D`               Trash                      |nvim_tree.api.fs.trash_visual()|
+`c`               Copy                       |nvim_tree.api.fs.copy.visual()|
+`x`               Cut                        |nvim_tree.api.fs.cut_visual()|
 
 ==============================================================================
 Quickstart: Custom Mappings             *nvim-tree-quickstart-custom-mappings*
@@ -458,6 +464,12 @@ You are encouraged to copy these to your {on_attach} function. >lua
   vim.keymap.set("n", "Y",              api.fs.copy.relative_path,          opts("Copy Relative Path"))
   vim.keymap.set("n", "<2-LeftMouse>",  api.node.open.edit,                 opts("Open"))
   vim.keymap.set("n", "<2-RightMouse>", api.tree.change_root_to_node,       opts("CD"))
+
+  vim.keymap.set("x", "m",              api.marks.toggle_visual,            opts("Toggle Bookmark"))
+  vim.keymap.set("x", "d",              api.fs.remove_visual,              opts("Delete"))
+  vim.keymap.set("x", "D",              api.fs.trash_visual,               opts("Trash"))
+  vim.keymap.set("x", "c",              api.fs.copy.visual,                opts("Copy"))
+  vim.keymap.set("x", "x",              api.fs.cut_visual,                 opts("Cut"))
   -- END_ON_ATTACH_DEFAULT
 <
 Alternatively, you may apply these default mappings from your
@@ -2461,6 +2473,9 @@ copy.relative_path({node})             *nvim_tree.api.fs.copy.relative_path()*
     Parameters: ~
       • {node}  (`nvim_tree.api.Node?`)
 
+copy.visual()                                 *nvim_tree.api.fs.copy.visual()*
+    Copy all visually selected nodes to the nvim-tree clipboard.
+
 create({node})                                     *nvim_tree.api.fs.create()*
     Prompt to create a file or directory.
 
@@ -2479,6 +2494,9 @@ cut({node})                                           *nvim_tree.api.fs.cut()*
     Parameters: ~
       • {node}  (`nvim_tree.api.Node?`)
 
+cut_visual()                                   *nvim_tree.api.fs.cut_visual()*
+    Cut all visually selected nodes to the nvim-tree clipboard.
+
 paste({node})                                       *nvim_tree.api.fs.paste()*
     Paste from the nvim-tree clipboard.
 
@@ -2496,6 +2514,9 @@ remove({node})                                     *nvim_tree.api.fs.remove()*
     Parameters: ~
       • {node}  (`nvim_tree.api.Node?`)
 
+remove_visual()                             *nvim_tree.api.fs.remove_visual()*
+    Delete all visually selected nodes, prompting once.
+
 rename({node})                                     *nvim_tree.api.fs.rename()*
     Prompt to rename by name.
 
@@ -2532,6 +2553,9 @@ trash({node})                                       *nvim_tree.api.fs.trash()*
     Parameters: ~
       • {node}  (`nvim_tree.api.Node?`)
 
+trash_visual()                               *nvim_tree.api.fs.trash_visual()*
+    Trash all visually selected nodes, prompting once.
+
 
 ==============================================================================
 API: git                                                   *nvim-tree-api-git*
@@ -2609,6 +2633,9 @@ toggle({node})                                  *nvim_tree.api.marks.toggle()*
     Parameters: ~
       • {node}  (`nvim_tree.api.Node?`) file or directory
 
+toggle_visual()                          *nvim_tree.api.marks.toggle_visual()*
+    Toggle mark on all visually selected nodes.
+
 
 ==============================================================================
 API: node                                                 *nvim-tree-api-node*

scripts/help-defaults.sh

@@ -45,7 +45,7 @@ sed -i -e "/${begin}/,/${end}/{ /${begin}/{p; r /tmp/ON_ATTACH_DEFAULT.lua
 
 # help human
 echo > /tmp/ON_ATTACH_DEFAULT.help
-sed -E "s/^ *vim.keymap.set\(\"n\", \"(.*)\",.*api(.*),.*opts\(\"(.*)\".*$/'\`\1\`' '\3' '|nvim_tree.api\2()|'/g
+sed -E "s/^ *vim.keymap.set\(\".\", \"(.*)\",.*api(.*),.*opts\(\"(.*)\".*$/'\`\1\`' '\3' '|nvim_tree.api\2()|'/g
 " /tmp/ON_ATTACH_DEFAULT.lua | while read -r line
 do
 	eval "printf '%-17.17s %-26.26s %s\n' ${line}" >> /tmp/ON_ATTACH_DEFAULT.help