feat(global): Add store_link command to Org global

Closes #924

Author: kristijanhusak

docs/index.org

@@ -66,11 +66,13 @@ List of available actions:
 - =:Org capture {type?}= - Open capture template by the shortcut, for example =:Org capture t=. When =type= is omitted, it opens up Capture prompt.
 - =:Org install_treesitter_grammar= - Install the treesitter grammar for Orgmode. If installed, prompt to reinstall. Grammar is installed automatically
   on first run, but this is useful in case when there are issues with the grammar.
+- =:Org store_link= - [[file:/home/kristijan/github/orgmode/docs/configuration.org::#org_store_link][Store link]] to the headline under cursor. Works in both agenda and org files.
 
 All of the commands above can be executed through the global Lua =Org= variable. Examples:
 - =Org.help()=
 - =Org.helpgrep()=
 - =Org.install_treesitter_grammar()=
+- =Org.store_link()=
 - =Org.agenda()= - Opens =agenda= prompt
 - =Org.agenda.m()= - Opens =tags= view
 - =Org.capture()= - Opens capture prompt

lua/orgmode/agenda/init.lua

@@ -585,6 +585,21 @@ function Agenda:_remote_edit(opts)
   end)
 end
 
+---@return OrgHeadline | nil
+function Agenda:get_headline_at_cursor()
+  local line_nr = vim.fn.line('.')
+
+  for _, view in ipairs(self.views) do
+    local agenda_line = view:get_line(line_nr)
+    if agenda_line then
+      local headline = agenda_line.headline
+      if headline then
+        return headline
+      end
+    end
+  end
+end
+
 function Agenda:quit()
   vim.api.nvim_win_close(0, true)
 end

lua/orgmode/api/agenda.lua

@@ -105,18 +105,11 @@ end
 ---Get the headline at the cursor position in the agenda view
 ---@return OrgApiHeadline | nil
 function OrgAgenda.get_headline_at_cursor()
-  local line_nr = vim.fn.line('.')
-  local agenda_views = orgmode.agenda.views
-
-  for _, view in ipairs(agenda_views) do
-    local agenda_line = view:get_line(line_nr)
-    if agenda_line then
-      local headline = agenda_line.headline
-      if headline then
-        local file = require('orgmode.api').load(headline.file.filename)
-        return file:get_headline_on_line(headline:get_range().start_line)
-      end
-    end
+  local headline = orgmode.agenda:get_headline_at_cursor()
+
+  if headline then
+    local file = require('orgmode.api').load(headline.file.filename)
+    return file:get_headline_on_line(headline:get_range().start_line)
   end
 end
 

lua/orgmode/org/global.lua

@@ -75,6 +75,22 @@ local build = function(orgmode)
 
     agenda = generate_agenda_object(orgmode, config),
     capture = generate_capture_object(orgmode, config),
+
+    store_link = function()
+      ---@type OrgHeadline | nil
+      local headline = nil
+      if vim.bo.filetype == 'orgagenda' then
+        headline = orgmode.agenda:get_headline_at_cursor()
+      elseif vim.bo.filetype == 'org' then
+        headline = orgmode.files:get_current_file():get_closest_headline_or_nil()
+      end
+      if not headline then
+        require('orgmode.utils').echo_error('No headline found')
+        return
+      end
+      orgmode.links:store_link_to_headline(headline)
+      return require('orgmode.utils').echo_info('Stored: ' .. headline:get_title())
+    end,
   }
 
   _G.Org = OrgGlobal