feat(hooks): add yazi_opened hook

README.md

@@ -62,8 +62,11 @@ Using lazy.nvim:
     open_file_function = function(chosen_file) end,
 
     hooks = {
-      -- if you want to execute a custom action when yazi has been closed
-      -- successfully, you can define it here
+      -- if you want to execute a custom action when yazi has been opened,
+      -- you can define it here
+      yazi_opened = function(preselected_path) end,
+
+      -- when yazi was successfully closed
       yazi_closed_successfully = function(chosen_file) end,
     },
   },

lua/yazi.lua

@@ -84,6 +84,8 @@ function M.yazi(path)
         end
       end,
     })
+
+    M.config.hooks.yazi_opened(path)
   end
   vim.schedule(function()
     vim.cmd('startinsert')

lua/yazi/config.lua

@@ -11,6 +11,8 @@ function M.default()
       vim.cmd(string.format('edit %s', chosen_file))
     end,
     hooks = {
+      ---@diagnostic disable-next-line: unused-local
+      yazi_opened = function(_preselected_path) end,
       ---@diagnostic disable-next-line: unused-local
       yazi_closed_successfully = function(_chosen_file) end,
     },

lua/yazi/types.lua

@@ -6,6 +6,7 @@
 ---@field public hooks? YaziConfigHooks
 
 ---@class YaziConfigHooks
+---@field public yazi_opened? fun(preselected_path: string | nil): nil
 ---@field public yazi_closed_successfully? fun(chosen_file: string | nil): nil
 
 ---@class YaziRenameEvent

tests/yazi/example_spec.lua

@@ -87,6 +87,24 @@ describe('opening a file', function()
     end
   )
 
+  it('calls the yazi_opened hook when yazi is opened', function()
+    local spy_hook = spy.new()
+
+    ---@diagnostic disable-next-line: missing-fields
+    plugin.setup({
+      hooks = {
+        ---@diagnostic disable-next-line: assign-type-mismatch
+        yazi_opened = spy_hook,
+      },
+    })
+
+    vim.api.nvim_command('edit /abc/yazi_opened_hook_file.txt')
+
+    plugin.yazi()
+
+    assert.spy(spy_hook).was_called_with('/abc/yazi_opened_hook_file.txt')
+  end)
+
   it('calls the open_file_function to open the selected file', function()
     local spy_hook = spy.new(function(chosen_file)
       assert.equals('/abc/test-file.txt', chosen_file)