feat: add -keep_cursor flag for UgatermOpen

Author: uga-rosa

doc/ugaterm.txt

@@ -45,6 +45,7 @@ COMMANDS						*ugaterm-commands*
 			recently used one.
 	-toggle		If the terminal is already open, it will be closed.
 	-select		Uses |vim.ui.select()| to select the terminal to open.
+	-keep_cursor	Open a terminal without moving the cursor.
 
 
 							*:UgatermHide*

lua/ugaterm/init.lua

@@ -51,7 +51,7 @@ end
 function M.create_commands()
   vim.api.nvim_create_user_command("UgatermOpen", function(opt)
     local parsedArgs = parse(opt.fargs, {
-      boolean = { "new", "toggle", "select" },
+      boolean = { "new", "toggle", "select", "keep_cursor" },
       string = { "name" },
     })
     local cmd
@@ -74,7 +74,7 @@ function M.create_commands()
       if cmdline:sub(1, cursor_pos):find("%-name%s+%S*$") then
         return get_bufnames()
       end
-      local items = { "-new", "-toggle", "-select", "-name" }
+      local items = { "-new", "-toggle", "-select", "-keep_cursor", "-name" }
       for i = #items, 1, -1 do
         if cmdline:find(items[i], 1, true) then
           table.remove(items, i)

lua/ugaterm/terminal.lua

@@ -62,7 +62,7 @@ end
 
 --- Open a most recently used terminal or new one.
 --- If it's already open, exit immediately.
----@param flags { new: boolean?, toggle: boolean?, select: boolean? }
+---@param flags { new: boolean?, toggle: boolean?, select: boolean?, keep_cursor: boolean? }
 ---@param name? string
 ---@param cmd? string | string[]
 function Terminal:open(flags, name, cmd)
@@ -93,6 +93,11 @@ function Terminal:open(flags, name, cmd)
 
     self:send(cmd)
     vim.cmd("do User UgatermEnter")
+    if flags.keep_cursor then
+      vim.schedule(function()
+        vim.fn.win_gotoid(self.prev_winid)
+      end)
+    end
   end
 
   if flags.select then

lua/ugaterm/terminal_spec.lua

@@ -62,6 +62,15 @@ describe("Test for terminal", function()
       terminal:open({ select = true })
       assert.equal("terminal://1", vim.api.nvim_buf_get_name(0))
     end)
+
+    it("-keep_cursor", function()
+      assert.equal(1, num_win())
+      local prev_winid = vim.api.nvim_get_current_win()
+      terminal:open({ keep_cursor = true })
+      vim.wait(500)
+      assert.equal(2, num_win())
+      assert.equal(prev_winid, vim.api.nvim_get_current_win())
+    end)
   end)
 
   describe("hide()", function()