feat(event): add au, global: NvimTreeRequired, NvimTreeSetup (#1912)

* feat(even): add autocommands NvimTreeRequired, NvimTreeSetup

* feat(event): add vim.g.NvimTreeRequired, vim.g.NvimTreeSetup

doc/nvim-tree-lua.txt

@@ -1674,6 +1674,24 @@ e.g. handler for node renamed: >
                 handler parameters: ~
                   {buf}          `{number} `API buffer handle (buffer number)
 
+|nvim_tree_events_startup|
+
+There are two special startup events in the form of User autocommands:
+
+`NvimTreeRequired`      first `require("nvim-tree")`
+`NvimTreeSetup`         `setup({})` completed
+
+Immediately before firing: a global variable of the same name will be set to a
+value of 1.
+
+Example subscription: >
+  vim.api.nvim_create_autocmd("User", {
+    pattern = "NvimTreeRequired",
+    callback = function(data)
+      ---
+    end,
+  })
+<
 ==============================================================================
  9. BOOKMARKS                                            *nvim-tree-bookmarks*
 

lua/nvim-tree.lua

@@ -865,7 +865,12 @@ function M.setup(conf)
 
   vim.schedule(function()
     M.on_enter(netrw_disabled)
+    vim.g.NvimTreeSetup = 1
+    vim.api.nvim_exec_autocmds("User", { pattern = "NvimTreeSetup" })
   end)
 end
 
+vim.g.NvimTreeRequired = 1
+vim.api.nvim_exec_autocmds("User", { pattern = "NvimTreeRequired" })
+
 return M