feat(pickers): add an option to resume and select the entry

Author: delphinus

doc/telescope.txt

@@ -1251,6 +1251,9 @@ builtin.resume({opts})                            *telescope.builtin.resume()*
     Options: ~
         {cache_index} (number)  what picker to resume, where 1 denotes most
                                 recent (default: 1)
+        {select_pos}  (number)  select the entry that position is specified
+                                by this value and do `actions.select_default`
+                                (default: nil)
 
 
 builtin.pickers({opts})                          *telescope.builtin.pickers()*

lua/telescope/builtin/__internal.lua

@@ -148,6 +148,18 @@ internal.resume = function(opts)
     })
     return
   end
+  if opts.select_pos then
+    if picker.manager:num_results() <= math.abs(opts.select_pos) then
+      utils.notify("builtin.resume", {
+        msg = string.format("The picker has less entries than supplied pos: %d", opts.select_pos),
+        level = "ERROR",
+      })
+      return
+    end
+    opts._select_pos = opts.select_pos
+    opts.select_pos = nil
+  end
+
   -- reset layout strategy and get_window_options if default as only one is valid
   -- and otherwise unclear which was actually set
   if picker.layout_strategy == conf.layout_strategy then

lua/telescope/pickers.lua

@@ -324,6 +324,8 @@ function Picker:new(opts)
 
     cache_picker = config.resolve_table_opts(opts.cache_picker, vim.deepcopy(config.values.cache_picker)),
 
+    _select_pos = opts._select_pos,
+
     __scrolling_limit = tonumber(vim.F.if_nil(opts.temp__scrolling_limit, 250)),
 
     __locations_input = vim.F.if_nil(opts.__locations_input, false),
@@ -1708,6 +1710,10 @@ function Picker:_resume_picker()
         vim.cmd "do User TelescopeResumePost"
       end)
     end
+    if self._select_pos then
+      self:move_selection(self._select_pos)
+      vim.schedule_wrap(actions.select_default)(self.prompt_bufnr)
+    end
   end
   -- if text changed, required to set anew to restart finder; otherwise hl and selection
   if self.cache_picker.cached_prompt ~= self.default_text then