feat(global): add :Org attach subcommand

This brings the feature in line with capture and agenda, which similarly
have a top-level menu prompt.

Author: troiganto

docs/index.org

@@ -64,6 +64,7 @@ List of available actions:
 - =:Org helpgrep= - Open search agenda view that allows searching through the documentation
 - =:Org agenda {type?}= - Open agenda view by the shortcut, for example =:Org agenda M= will open =tags_todo= view. When =type= is omitted, it opens up Agenda view.
 - =:Org capture {type?}= - Open capture template by the shortcut, for example =:Org capture t=. When =type= is omitted, it opens up Capture prompt.
+- =:Org attach {type?}= - Take attachment action by the shortcut, for example =:Org attach o= will prompt for an attached file to open. When =type= is omitted, it opens up Attach 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.
 
@@ -75,3 +76,5 @@ All of the commands above can be executed through the global Lua =Org= variable.
 - =Org.agenda.m()= - Opens =tags= view
 - =Org.capture()= - Opens capture prompt
 - =Org.capture.t()= - Opens capture template for =t= shortcut
+- =Org.attach()= - Opens attach prompt
+- =Org.attach.c()= - Opens attach template for =c= shortcut

lua/orgmode/attach/init.lua

@@ -23,8 +23,8 @@ end
 
 ---The dispatcher for attachment commands.
 ---Shows a list of commands and prompts for another key to execute a command.
----@return nil
-function Attach:prompt()
+---@return OrgMenu
+function Attach:_build_menu()
   local menu = Menu:new({
     title = 'Press key for an attach command',
     prompt = 'Press key for an attach command',
@@ -147,9 +147,26 @@ function Attach:prompt()
   menu:add_option({ label = 'Quit', key = 'q' })
   menu:add_separator({ icon = ' ', length = 1 })
 
+  return menu
+end
+
+---@return nil
+function Attach:prompt()
+  local menu = self:_build_menu()
   return menu:open()
 end
 
+---@param key string
+---@return string?
+function Attach:open_by_key(key)
+  local menu = self:_build_menu()
+  local item = menu:get_entry_by_key(key)
+  if not item then
+    return utils.echo_error('No attachment action with key ' .. key)
+  end
+  return item.action()
+end
+
 ---Get the current attachment node.
 ---
 ---@return OrgAttachNode

lua/orgmode/org/global.lua

@@ -46,6 +46,25 @@ local function generate_capture_object(orgmode, config)
   return Capture
 end
 
+---@param orgmode Org
+---@param config OrgConfig
+local function generate_attach_object(orgmode, config)
+  local Attach = setmetatable({}, {
+    __call = function()
+      return orgmode.attach:prompt()
+    end,
+  })
+
+  local attach_keys = { 'a', 'c', 'm', 'l', 'y', 'u', 'b', 'n', 'z', 'o', 'O', 'f', 'F', 'd', 'D', 's', 'S' }
+  for _, key in ipairs(attach_keys) do
+    Attach[key] = function()
+      return orgmode.agenda:open_by_key(key)
+    end
+  end
+
+  return Attach
+end
+
 ---@param orgmode Org
 local build = function(orgmode)
   local config = require('orgmode.config')
@@ -75,6 +94,7 @@ local build = function(orgmode)
 
     agenda = generate_agenda_object(orgmode, config),
     capture = generate_capture_object(orgmode, config),
+    attach = generate_attach_object(orgmode, config),
   }
 
   _G.Org = OrgGlobal