From 5a7a87d170615ecd6f43f86d53e4468e2fea7316 Mon Sep 17 00:00:00 2001
From: Prad Nukala <prad@sonr.io>
Date: Thu, 13 Aug 2026 16:04:43 -0400
Subject: [PATCH] feat(plugins): replace yazi integration with mini.files
 explorer

---
 lua/plugins/mini-files.lua | 136 +++++++++++++++++++++++++++++++++++++
 1 file changed, 136 insertions(+)
 create mode 100644 lua/plugins/mini-files.lua

diff --git a/lua/plugins/mini-files.lua b/lua/plugins/mini-files.lua
new file mode 100644
index 0000000..38dfb8f
--- /dev/null
+++ b/lua/plugins/mini-files.lua
@@ -0,0 +1,136 @@
+--- mini.files as the default file explorer (replaces the yazi.nvim integration)
+---
+--- Navigation is stock mini.files (h/l columns, q close, `=` synchronize).
+--- Neo-tree muscle memory is kept via buffer-local maps: `a` adds a file,
+--- `A` adds a directory -- both prompt for the name via Snacks.input, create
+--- the entry on disk immediately, and refresh the explorer (no `=` needed).
+
+--- Open the explorer anchored at the current file (falls back to cwd for
+--- terminals / pickers / unnamed buffers).
+local function open_at_current_file()
+  local path = vim.api.nvim_buf_get_name(0)
+  if vim.bo.buftype ~= "" or vim.uv.fs_stat(path) == nil then path = vim.uv.cwd() end
+  require("mini.files").open(path)
+end
+
+--- Buffer-local <C-x>/<C-v>/<C-t> (picker convention, matches the old yazi
+--- binds): open entry under cursor in a horizontal/vertical split or new tab.
+--- Recipe from :h MiniFiles-examples.
+local function map_split(buf_id, lhs, direction)
+  vim.keymap.set("n", lhs, function()
+    local mf = require "mini.files"
+    local entry = mf.get_fs_entry()
+    if entry == nil or entry.fs_type ~= "file" then return end
+    local new_target = vim.api.nvim_win_call(mf.get_explorer_state().target_window, function()
+      vim.cmd(direction .. " split")
+      return vim.api.nvim_get_current_win()
+    end)
+    mf.set_target_window(new_target)
+    mf.go_in { close_on_file = true }
+  end, { buffer = buf_id, desc = "Open in " .. direction .. " split" })
+end
+
+--- Prompt for a name with Snacks.input and create the entry inside the
+--- focused explorer directory. Created directly on the file system (create
+--- is not LSP-relevant, unlike rename/move), then MiniFiles.synchronize()
+--- picks it up as an external change -- no confirmation dialog involved.
+--- Neo-tree parity: `a` with a trailing `/` or nested `dir/file` also works.
+---@param force_dir boolean `A`: always create a directory
+local function add_entry(force_dir)
+  local mf = require "mini.files"
+  local state = mf.get_explorer_state()
+  if state == nil then return end
+  local dir = state.branch[state.depth_focus]
+  require("snacks").input({
+    prompt = force_dir and "New directory" or "New file",
+  }, function(name)
+    if name == nil or name == "" then return end
+    vim.schedule(function()
+      local path = vim.fs.joinpath(dir, (name:gsub("/+$", "")))
+      if force_dir or vim.endswith(name, "/") then
+        vim.fn.mkdir(path, "p")
+      else
+        vim.fn.mkdir(vim.fs.dirname(path), "p")
+        local fd = vim.uv.fs_open(path, "a", 420) -- "a": never truncate existing
+        if fd then vim.uv.fs_close(fd) end
+      end
+      mf.synchronize()
+      -- put the cursor on the created (top-level) entry
+      local seg = name:match "^[^/]+"
+      for i, line in ipairs(vim.api.nvim_buf_get_lines(0, 0, -1, false)) do
+        if line:find("/" .. vim.pesc(seg) .. "$") then
+          vim.api.nvim_win_set_cursor(0, { i, 0 })
+          break
+        end
+      end
+    end)
+  end)
+end
+
+---@type LazySpec
+return {
+  {
+    "nvim-mini/mini.files",
+    -- load during startup: the `nvim <dir>` hijack (use_as_default_explorer)
+    -- needs setup() to have run before the directory buffer is entered
+    lazy = false,
+    keys = {
+      {
+        "<C-e>",
+        mode = { "n", "v" },
+        function()
+          if not require("mini.files").close() then open_at_current_file() end
+        end,
+        desc = "Toggle Explorer (mini.files)",
+      },
+      {
+        "<leader>-",
+        mode = { "n", "v" },
+        open_at_current_file,
+        desc = "Open mini.files at the current file",
+      },
+      {
+        -- replaces AstroNvim's <Leader>o "Toggle Explorer Focus" (neo-tree)
+        "<leader>o",
+        open_at_current_file,
+        desc = "Open Explorer (mini.files at current file)",
+      },
+      {
+        "<leader>cw",
+        function() require("mini.files").open(vim.uv.cwd(), false) end,
+        desc = "Open mini.files in nvim's working directory",
+      },
+    },
+    opts = {
+      options = {
+        -- take over `nvim <dir>` / :edit <dir> from netrw
+        use_as_default_explorer = true,
+      },
+    },
+    config = function(_, opts)
+      require("mini.files").setup(opts)
+
+      vim.api.nvim_create_autocmd("User", {
+        pattern = "MiniFilesBufferCreate",
+        group = vim.api.nvim_create_augroup("minifiles_user_keys", { clear = true }),
+        desc = "Neo-tree style a/A + picker-style split opens in mini.files buffers",
+        callback = function(args)
+          local buf = args.data.buf_id
+          -- neo-tree muscle memory: prompt for a name, create, refresh
+          vim.keymap.set("n", "a", function() add_entry(false) end, { buffer = buf, desc = "Add file" })
+          vim.keymap.set("n", "A", function() add_entry(true) end, { buffer = buf, desc = "Add directory" })
+          map_split(buf, "<C-x>", "belowright horizontal")
+          map_split(buf, "<C-v>", "belowright vertical")
+          map_split(buf, "<C-t>", "tab")
+        end,
+      })
+    end,
+    init = function()
+      -- netrw stays fully replaced (was set by the yazi spec before)
+      vim.g.loaded_netrwPlugin = 1
+    end,
+  },
+
+  -- neo-tree is fully replaced by mini.files (AstroNvim core ships it)
+  { "nvim-neo-tree/neo-tree.nvim", enabled = false },
+}