Vinegar-Style API: `open_replacing_current_buffer`

[alex-courtis]

:h nvim-tree-vinegar is mostly functional however has a couple of limitations: #1914

open_replacing_current_buffer predates API and could be moved: api.tree.open and api.tree.toggle could take an open_in_current option.

Useful for #1669