feat(misc): add peek functionality

Author: 231tr0n

lua/mini/misc.lua

@@ -9,6 +9,8 @@
 --- - |MiniMisc.bench_time()| to benchmark function execution time.
 ---   Useful in combination with `stat_summary()`.
 ---
+--- - |MiniMisc.peek()| to peek a line by entering the linenr in cmdline.
+---
 --- - |MiniMisc.put()| and |MiniMisc.put_text()| to pretty print its arguments
 ---   into command line and current buffer respectively.
 ---
@@ -108,6 +110,55 @@ MiniMisc.get_gutter_width = function(win_id)
   return vim.fn.getwininfo(win_id)[1].textoff
 end
 
+--- Peek a line by entering the linenr in cmdline.
+MiniMisc.peek = function()
+  local win_states = {}
+
+  local function save_win_state(winnr)
+    win_states[winnr] = {
+      foldenable = vim.api.nvim_get_option_value('foldenable', { win = winnr }),
+      cursorline = vim.api.nvim_get_option_value('cursorline', { win = winnr }),
+      cursor = vim.api.nvim_win_get_cursor(winnr),
+    }
+  end
+
+  local function restore_win_state(winnr)
+    if not win_states[winnr] then return end
+
+    vim.api.nvim_set_option_value('foldenable', win_states[winnr].foldenable, { win = winnr })
+    vim.api.nvim_set_option_value('cursorline', win_states[winnr].cursorline, { win = winnr })
+    vim.api.nvim_win_set_cursor(winnr, win_states[winnr].cursor)
+
+    win_states[winnr] = nil
+  end
+
+  local goto_linenr = function(winnr, linenr)
+    linenr = math.max(math.min(linenr, vim.api.nvim_buf_line_count(vim.api.nvim_win_get_buf(winnr))), 1)
+
+    if not win_states[winnr] then save_win_state(winnr) end
+
+    vim.api.nvim_set_option_value('foldenable', false, { win = winnr })
+    vim.api.nvim_set_option_value('cursorline', true, { win = winnr })
+
+    vim.api.nvim_win_set_cursor(winnr, { linenr, 1 })
+
+    vim.cmd('redraw')
+  end
+
+  vim.api.nvim_create_autocmd('CmdlineChanged', {
+    pattern = '*',
+    callback = function()
+      local cmdline_str = vim.api.nvim_call_function('getcmdline', {})
+      if tonumber(cmdline_str) then goto_linenr(vim.api.nvim_get_current_win(), tonumber(cmdline_str)) end
+    end,
+  })
+
+  vim.api.nvim_create_autocmd('CmdlineLeave', {
+    pattern = '*',
+    callback = function() restore_win_state(vim.api.nvim_get_current_win()) end,
+  })
+end
+
 --- Print Lua objects in command line
 ---
 ---@param ... any Any number of objects to be printed each on separate line.