feat: support id links for headlines

Relies on an api extension of orgmode.

Author: seflue

lua/telescope-orgmode/actions.lua

@@ -65,7 +65,7 @@ function M.insert(_)
 
     -- Link to a specific heading if is set
     if entry.value.headline then
-      destination = 'file:' .. entry.value.file.filename .. '::*' .. entry.value.headline.title
+      destination = org.get_link_to_headline(entry.value.headline)
     end
 
     org.insert_link(destination)
@@ -83,11 +83,11 @@ function M._find_orgfiles(opts, prompt_bufnr)
   M._update_picker(orgfiles, opts.prompt_titles.orgfiles, prompt_bufnr)
 end
 
-function M._update_picker(results, title, prompt_bufnr)
+function M._update_picker(finder, title, prompt_bufnr)
   local current_picker = action_state.get_current_picker(prompt_bufnr)
 
   current_picker.layout.prompt.border:change_title(title)
-  current_picker:refresh(results)
+  current_picker:refresh(finder)
 end
 
 return M

lua/telescope-orgmode/entry_maker/headlines.lua

@@ -20,7 +20,6 @@ local function index_headlines(file_results, opts)
           file = file_entry.file,
           filename = file_entry.filename,
           headline = headline,
-          title = nil,
         }
         table.insert(results, entry)
       end

lua/telescope-orgmode/org.lua

@@ -28,6 +28,12 @@ function M.refile(opts)
   return OrgApi.refile(opts)
 end
 
+---@param headline OrgApiHeadline
+---@return string
+function M.get_link_to_headline(headline)
+  return OrgApi.get_link_to_headline(headline._section) ---@diagnostic disable-line: invisible
+end
+
 function M.insert_link(destination)
   return OrgApi.insert_link(destination)
 end

lua/telescope-orgmode/typehints.lua

@@ -39,6 +39,10 @@
 ---@field start_col number
 ---@field end_line number
 ---@field end_col number
+---
+---@class OrgHeadline
+---@field headline TSNode
+---@field file OrgFile
 
 ---@class OrgApiHeadline
 ---@field title string headline title without todo keyword, tags and priority. Ex. `* TODO I am a headline  :SOMETAG:` returns `I am a headline`
@@ -59,7 +63,10 @@
 ---@field priority string|nil
 ---@field is_archived boolean headline marked with the `:ARCHIVE:` tag
 ---@field headlines OrgApiHeadline[]
---
+---@field id_get_or_create number
+---@field private _section OrgHeadline
+---@field private _index number
+
 ---@class OrgApiRefileOpts
 ---@field source OrgApiHeadline
 ---@field destination OrgApiFile | OrgApiHeadline