chore(master): release nvim-tree 1.17.1

* fix(#3327): pass nvim_tree.api.node.open.Opts to all applicable nvim_tree.api.node.open function

* fix(#3327): pass nvim_tree.api.node.open.Opts to all applicable nvim_tree.api.node.open function

* fix(#3327): pass nvim_tree.api.node.open.Opts to all applicable nvim_tree.api.node.open function

* fix(#3327): pass nvim_tree.api.node.open.Opts to all applicable nvim_tree.api.node.open function

* fix(#3327): pass nvim_tree.api.node.open.Opts to all applicable nvim_tree.api.node.open function

.github/workflows/ci.yml

@@ -27,7 +27,7 @@ jobs:
         uses: actions/checkout@v6
 
       - name: install lua ${{ matrix.lua_version }}
-        uses: leafo/gh-actions-lua@v12
+        uses: leafo/gh-actions-lua@v13
         with:
           luaVersion: ${{ matrix.lua_version }}
 
@@ -87,11 +87,12 @@ jobs:
       - run: make format-check
 
       - name: build Nvim from source
+        if: ${{ matrix.nvim_version == 'stable' }}
         run: |
           mkdir -p "${DIR_NVIM_SRC}"
           curl -L "https://github.com/neovim/neovim/archive/refs/tags/${{ matrix.nvim_version }}.tar.gz" | tar zx --directory "${DIR_NVIM_SRC}/.."
           cd "${DIR_NVIM_SRC}"
           make doc
-          make lintdoc
 
       - run: make help-check
+        if: ${{ matrix.nvim_version == 'stable' }}

.github/workflows/release-please.yml

@@ -14,7 +14,7 @@ jobs:
   release-please:
     runs-on: ubuntu-latest
     steps:
-      - uses: googleapis/release-please-action@v4
+      - uses: googleapis/release-please-action@v5
         id: release
       - uses: actions/checkout@v6
       - name: tag major and minor versions

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.17.0"
+  ".": "1.17.1"
 }

CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [1.17.1](https://github.com/nvim-tree/nvim-tree.lua/compare/nvim-tree-v1.17.0...nvim-tree-v1.17.1) (2026-06-08)
+
+
+### Bug Fixes
+
+* **#3312:** correct cursor when full name shown, requires nvim 0.12.2+ ([#3316](https://github.com/nvim-tree/nvim-tree.lua/issues/3316)) ([d277467](https://github.com/nvim-tree/nvim-tree.lua/commit/d277467fc0d1d0e2bca88165a1de6b526f9f6fe8))
+* **#3324:** deprecated BufModifiedSet event replaced by OptionSet event for Nvim 0.13+ ([#3325](https://github.com/nvim-tree/nvim-tree.lua/issues/3325)) ([f9bfc00](https://github.com/nvim-tree/nvim-tree.lua/commit/f9bfc0059eca24546b69a7006110463da4808f8f))
+* **#3327:** pass nvim_tree.api.node.open.Opts to all applicable nvim_tree.api.node.open function ([#3329](https://github.com/nvim-tree/nvim-tree.lua/issues/3329)) ([07f541f](https://github.com/nvim-tree/nvim-tree.lua/commit/07f541fcaa4a5ae019598240362449ab7e9812b3))
+* **full-name:** lower `zindex` to get consistent cursor shape ([d277467](https://github.com/nvim-tree/nvim-tree.lua/commit/d277467fc0d1d0e2bca88165a1de6b526f9f6fe8))
+
 ## [1.17.0](https://github.com/nvim-tree/nvim-tree.lua/compare/nvim-tree-v1.16.0...nvim-tree-v1.17.0) (2026-04-07)
 
 

CONTRIBUTING.md

@@ -184,7 +184,7 @@ make help-update
   - Generate config classes `*nvim-tree-config*`
   - Generate API `*nvim-tree-api*`
 
-## Checking And Linting
+## Checking
 
 This is run in CI. Commit or stage your changes and run:
 
@@ -194,7 +194,6 @@ make help-check
 
 - Re-runs `make help-update`
 - Checks that `git diff` is empty, to ensure that all content has been generated. This is why a stage or commit is necessary.
-- Lints `doc/nvim-tree-lua.txt` using `scripts/vimdoc.sh lintdoc` to check for no broken links etc.
 
 # Windows
 

Makefile

@@ -43,11 +43,9 @@ help-update:
 
 #
 # CI
-# --ignore-blank-lines is used as nightly has removed unnecessary blank lines that stable (0.11.5) currently inserts
 #
 help-check: help-update
-	scripts/vimdoc.sh lintdoc
+	git diff --exit-code doc/nvim-tree-lua.txt
-	git diff --ignore-blank-lines --exit-code doc/nvim-tree-lua.txt
 
 
 .PHONY: all lint style check luacheck style-check style-doc luals format-fix format-check help-update help-check

doc/nvim-tree-lua.txt

@@ -1075,8 +1075,6 @@ Config                                                      *nvim-tree-config*
       • {log}?                                 (`nvim_tree.config.log`)
                                                |nvim_tree.config.log|
 
-
-
 ==============================================================================
 Config: sort                                           *nvim-tree-config-sort*
 
@@ -1115,8 +1113,6 @@ Config: sort                                           *nvim-tree-config-sort*
                           folders. Has no effect when {sorter} is a function.
                           Overrides {folders_first}.
 
-
-
 ==============================================================================
 Config: view                                           *nvim-tree-config-view*
 
@@ -1201,8 +1197,6 @@ Config: view                                           *nvim-tree-config-view*
       • {padding}?         (`nvim_tree.config.view.width.spec`, default: `1`)
                            Extra padding to the right.
 
-
-
 ==============================================================================
 Config: renderer                                   *nvim-tree-config-renderer*
 
@@ -1447,8 +1441,6 @@ Config: renderer                                   *nvim-tree-config-renderer*
                           • {bottom}? (`string`) (default: `"─"`)
                           • {none}? (`string`) (default: `" "`)
 
-
-
 ==============================================================================
 Config: hijack_directories               *nvim-tree-config-hijack-directories*
 
@@ -1465,8 +1457,6 @@ Config: hijack_directories               *nvim-tree-config-hijack-directories*
       • {auto_open}?  (`boolean`, default: `true`) Open if the tree was
                       previously closed.
 
-
-
 ==============================================================================
 Config: update_focused_file             *nvim-tree-config-update-focused-file*
 
@@ -1497,8 +1487,6 @@ Config: update_focused_file             *nvim-tree-config-update-focused-file*
                         tree if the file isn't found under the current root
                         directory.
 
-
-
 ==============================================================================
 Config: git                                             *nvim-tree-config-git*
 
@@ -1531,8 +1519,6 @@ Config: git                                             *nvim-tree-config-git*
       • {cygwin_support}?     (`boolean`, default: `false`) Use `cygpath` if
                               available to resolve paths for git.
 
-
-
 ==============================================================================
 Config: diagnostics                             *nvim-tree-config-diagnostics*
 
@@ -1565,8 +1551,6 @@ Config: diagnostics                             *nvim-tree-config-diagnostics*
                               • {warning}? (`string`) (default: `""` )
                               • {error}? (`string`) (default: `""` )
 
-
-
 ==============================================================================
 Config: modified                                   *nvim-tree-config-modified*
 
@@ -1587,13 +1571,11 @@ Config: modified                                   *nvim-tree-config-modified*
                               indication on open directories. Requires
                               {show_on_dirs}.
 
-
-
 ==============================================================================
 Config: filters                                     *nvim-tree-config-filters*
 
 *nvim_tree.config.filters*
-    Filters may be applied to the tree to exlude the display of
+    Filters may be applied to the tree to exclude the display of
     file/directories.
 
     Multiple filters may be applied at once.
@@ -1642,8 +1624,6 @@ Config: filters                                     *nvim-tree-config-filters*
                         (default: `{}`)
       • {exclude}?      (`string[]`) (default: `{}`)
 
-
-
 ==============================================================================
 Config: live_filter                             *nvim-tree-config-live-filter*
 
@@ -1660,8 +1640,6 @@ Config: live_filter                             *nvim-tree-config-live-filter*
       • {always_show_folders}?  (`boolean`, default: `true`) Whether to filter
                                 folders or not.
 
-
-
 ==============================================================================
 Config: filesystem_watchers             *nvim-tree-config-filesystem-watchers*
 
@@ -1708,8 +1686,6 @@ Config: filesystem_watchers             *nvim-tree-config-filesystem-watchers*
                            {debounce_delay}. Set to 0 to allow unlimited
                            consecutive events.
 
-
-
 ==============================================================================
 Config: actions                                     *nvim-tree-config-actions*
 
@@ -1831,8 +1807,6 @@ Config: actions                                     *nvim-tree-config-actions*
                          displays a file when removing that file from the
                          tree.
 
-
-
 ==============================================================================
 Config: trash                                         *nvim-tree-config-trash*
 
@@ -1846,8 +1820,6 @@ Config: trash                                         *nvim-tree-config-trash*
     Fields: ~
       • {cmd}?  (`string`) (default: `"gio trash"` or `"trash"`)
 
-
-
 ==============================================================================
 Config: tab                                             *nvim-tree-config-tab*
 
@@ -1867,8 +1839,6 @@ Config: tab                                             *nvim-tree-config-tab*
       • {ignore}?  (`string[]`, default: `{}`) List of filetypes or buffer
                    names on new tab that will prevent `open` and `close`
 
-
-
 ==============================================================================
 Config: notify                                       *nvim-tree-config-notify*
 
@@ -1886,8 +1856,6 @@ Config: notify                                       *nvim-tree-config-notify*
       • {absolute_path}?  (`boolean`, default: `true`) Use absolute paths in
                           FS action notifications, otherwise item names.
 
-
-
 ==============================================================================
 Config: bookmarks                                 *nvim-tree-config-bookmarks*
 
@@ -1900,8 +1868,6 @@ Config: bookmarks                                 *nvim-tree-config-bookmarks*
     Fields: ~
       • {persist}?  (`boolean|string`) (default: `false`)
 
-
-
 ==============================================================================
 Config: help                                           *nvim-tree-config-help*
 
@@ -1915,8 +1881,6 @@ Config: help                                           *nvim-tree-config-help*
     Fields: ~
       • {sort_by}?  (`nvim_tree.config.help.sort_by`) (default: `"key"`)
 
-
-
 ==============================================================================
 Config: ui                                               *nvim-tree-config-ui*
 
@@ -1935,8 +1899,6 @@ Config: ui                                               *nvim-tree-config-ui*
       • {default_yes}?  (`boolean`, default: `false`) If `true` the prompt
                         will be `Y/n`, otherwise `y/N`
 
-
-
 ==============================================================================
 Config: experimental                           *nvim-tree-config-experimental*
 
@@ -1946,8 +1908,6 @@ Config: experimental                           *nvim-tree-config-experimental*
     In the event of a problem please disable the experiment and raise an
     issue.
 
-
-
 ==============================================================================
 Config: log                                             *nvim-tree-config-log*
 
@@ -1982,8 +1942,6 @@ Config: log                                             *nvim-tree-config-log*
                         |nvim_tree.config.filesystem_watchers| processing,
                         verbose.
 
-
-
 ==============================================================================
 Config: Default                                     *nvim-tree-config-default*
 
@@ -2273,8 +2231,6 @@ Following is the default configuration, see |nvim_tree.config| for details. >lua
     }
 <
 
-
-
 ==============================================================================
 API                                                            *nvim-tree-api*
 
@@ -2354,8 +2310,6 @@ e.g. the following are functionally identical: >lua
       • {dir}?   (`table<"direct"|"indirect", nvim_tree.git.XY[]>`) direct
                  inclusive-or indirect status
 
-
-
 ==============================================================================
 API: appearance                                     *nvim-tree-api-appearance*
 
@@ -2811,6 +2765,13 @@ navigate.sibling.prev({node})
     Parameters: ~
       • {node}  (`nvim_tree.api.Node?`) directory or file
 
+open.drop({node})                             *nvim_tree.api.node.open.drop()*
+    Switch to window with selected file if it exists, otherwise open, see
+    |:drop|
+
+    Parameters: ~
+      • {node}  (`nvim_tree.api.Node?`) directory or file
+
 open.edit({node}, {opts})                     *nvim_tree.api.node.open.edit()*
     • file: open as per |nvim_tree.config.actions.open_file|
     • directory: expand or collapse
@@ -2824,39 +2785,64 @@ open.edit({node}, {opts})                     *nvim_tree.api.node.open.edit()*
                 • {focus}? (`boolean`, default: false) Keep focus in the tree
                   when opening the file.
 
-open.horizontal({node})                 *nvim_tree.api.node.open.horizontal()*
+open.horizontal({node}, {opts})         *nvim_tree.api.node.open.horizontal()*
     Open file in a new horizontal split.
 
     Parameters: ~
       • {node}  (`nvim_tree.api.Node?`) file
+      • {opts}  (`table?`) optional
+                • {quit_on_open}? (`boolean`, default: false) Quits the tree
+                  when opening the file.
+                • {focus}? (`boolean`, default: false) Keep focus in the tree
+                  when opening the file.
 
                               *nvim_tree.api.node.open.horizontal_no_picker()*
-open.horizontal_no_picker({node})
+open.horizontal_no_picker({node}, {opts})
     Open file in a new horizontal split without using the window picker.
 
     Parameters: ~
       • {node}  (`nvim_tree.api.Node?`) file
+      • {opts}  (`table?`) optional
+                • {quit_on_open}? (`boolean`, default: false) Quits the tree
+                  when opening the file.
+                • {focus}? (`boolean`, default: false) Keep focus in the tree
+                  when opening the file.
 
                                   *nvim_tree.api.node.open.no_window_picker()*
-open.no_window_picker({node})
+open.no_window_picker({node}, {opts})
     Open file without using the window picker.
 
     Parameters: ~
       • {node}  (`nvim_tree.api.Node?`) file
+      • {opts}  (`table?`) optional
+                • {quit_on_open}? (`boolean`, default: false) Quits the tree
+                  when opening the file.
+                • {focus}? (`boolean`, default: false) Keep focus in the tree
+                  when opening the file.
 
-open.preview({node})                       *nvim_tree.api.node.open.preview()*
+open.preview({node}, {opts})               *nvim_tree.api.node.open.preview()*
     Open file with |'bufhidden'| set to `delete`.
 
     Parameters: ~
       • {node}  (`nvim_tree.api.Node?`) directory or file
+      • {opts}  (`table?`) optional
+                • {quit_on_open}? (`boolean`, default: false) Quits the tree
+                  when opening the file.
+                • {focus}? (`boolean`, default: false) Keep focus in the tree
+                  when opening the file.
 
                                  *nvim_tree.api.node.open.preview_no_picker()*
-open.preview_no_picker({node})
+open.preview_no_picker({node}, {opts})
     Open file with |'bufhidden'| set to `delete` without using the window
     picker.
 
     Parameters: ~
       • {node}  (`nvim_tree.api.Node?`) directory or file
+      • {opts}  (`table?`) optional
+                • {quit_on_open}? (`boolean`, default: false) Quits the tree
+                  when opening the file.
+                • {focus}? (`boolean`, default: false) Keep focus in the tree
+                  when opening the file.
 
                                *nvim_tree.api.node.open.replace_tree_buffer()*
 open.replace_tree_buffer({node})
@@ -2865,15 +2851,20 @@ open.replace_tree_buffer({node})
     Parameters: ~
       • {node}  (`nvim_tree.api.Node?`) file
 
-open.tab({node})                               *nvim_tree.api.node.open.tab()*
+open.tab({node}, {opts})                       *nvim_tree.api.node.open.tab()*
     Open file in a new tab.
 
     Parameters: ~
       • {node}  (`nvim_tree.api.Node?`) directory or file
+      • {opts}  (`table?`) optional
+                • {quit_on_open}? (`boolean`, default: false) Quits the tree
+                  when opening the file.
+                • {focus}? (`boolean`, default: false) Keep focus in the tree
+                  when opening the file.
 
 open.tab_drop({node})                     *nvim_tree.api.node.open.tab_drop()*
-    Switch to tab containing window with selected file if it exists. Open file
+    Switch to tab containing window with selected file if it exists, otherwise
-    in new tab otherwise.
+    open in new tab, see |:drop|
 
     Parameters: ~
       • {node}  (`nvim_tree.api.Node?`) directory or file
@@ -2886,18 +2877,28 @@ open.toggle_group_empty({node})
     Parameters: ~
       • {node}  (`nvim_tree.api.Node?`) directory
 
-open.vertical({node})                     *nvim_tree.api.node.open.vertical()*
+open.vertical({node}, {opts})             *nvim_tree.api.node.open.vertical()*
     Open file in a new vertical split.
 
     Parameters: ~
       • {node}  (`nvim_tree.api.Node?`) file
+      • {opts}  (`table?`) optional
+                • {quit_on_open}? (`boolean`, default: false) Quits the tree
+                  when opening the file.
+                • {focus}? (`boolean`, default: false) Keep focus in the tree
+                  when opening the file.
 
                                 *nvim_tree.api.node.open.vertical_no_picker()*
-open.vertical_no_picker({node})
+open.vertical_no_picker({node}, {opts})
     Open file in a new vertical split without using the window picker.
 
     Parameters: ~
       • {node}  (`nvim_tree.api.Node?`) file
+      • {opts}  (`table?`) optional
+                • {quit_on_open}? (`boolean`, default: false) Quits the tree
+                  when opening the file.
+                • {focus}? (`boolean`, default: false) Keep focus in the tree
+                  when opening the file.
 
 run.cmd({node})                                 *nvim_tree.api.node.run.cmd()*
     Enter |cmdline| with the full path of the node and the cursor at the start
@@ -3466,6 +3467,4 @@ Contents of `my-decorator.lua`: >lua
     return MyDecorator
 <
 
-
-
  vim:tw=78:ts=8:sw=4:sts=4:et:ft=help:norl:

lua/nvim-tree/_meta/api/node.lua

@@ -16,6 +16,12 @@ nvim_tree.api.node.open = {}
 ---@field focus? boolean
 
 
+---
+---Switch to window with selected file if it exists, otherwise open, see [:drop]
+---
+---@param node? nvim_tree.api.Node directory or file
+function nvim_tree.api.node.open.drop(node) end
+
 ---
 ---- file: open as per [nvim_tree.config.actions.open_file]
 ---- directory: expand or collapse
@@ -29,31 +35,36 @@ function nvim_tree.api.node.open.edit(node, opts) end
 ---Open file in a new horizontal split.
 ---
 ---@param node? nvim_tree.api.Node file
-function nvim_tree.api.node.open.horizontal(node) end
+---@param opts? nvim_tree.api.node.open.Opts optional
+function nvim_tree.api.node.open.horizontal(node, opts) end
 
 ---
 ---Open file in a new horizontal split without using the window picker.
 ---
 ---@param node? nvim_tree.api.Node file
-function nvim_tree.api.node.open.horizontal_no_picker(node) end
+---@param opts? nvim_tree.api.node.open.Opts optional
+function nvim_tree.api.node.open.horizontal_no_picker(node, opts) end
 
 ---
 ---Open file without using the window picker.
 ---
 ---@param node? nvim_tree.api.Node file
-function nvim_tree.api.node.open.no_window_picker(node) end
+---@param opts? nvim_tree.api.node.open.Opts optional
+function nvim_tree.api.node.open.no_window_picker(node, opts) end
 
 ---
 ---Open file with ['bufhidden'] set to `delete`.
 ---
 ---@param node? nvim_tree.api.Node directory or file
-function nvim_tree.api.node.open.preview(node) end
+---@param opts? nvim_tree.api.node.open.Opts optional
+function nvim_tree.api.node.open.preview(node, opts) end
 
 ---
 ---Open file with ['bufhidden'] set to `delete` without using the window picker.
 ---
 ---@param node? nvim_tree.api.Node directory or file
-function nvim_tree.api.node.open.preview_no_picker(node) end
+---@param opts? nvim_tree.api.node.open.Opts optional
+function nvim_tree.api.node.open.preview_no_picker(node, opts) end
 
 ---
 ---Open file in place: in the nvim-tree window.
@@ -65,10 +76,11 @@ function nvim_tree.api.node.open.replace_tree_buffer(node) end
 ---Open file in a new tab.
 ---
 ---@param node? nvim_tree.api.Node directory or file
-function nvim_tree.api.node.open.tab(node) end
+---@param opts? nvim_tree.api.node.open.Opts optional
+function nvim_tree.api.node.open.tab(node, opts) end
 
 ---
----Switch to tab containing window with selected file if it exists. Open file in new tab otherwise.
+---Switch to tab containing window with selected file if it exists, otherwise open in new tab, see [:drop]
 ---
 ---@param node? nvim_tree.api.Node directory or file
 function nvim_tree.api.node.open.tab_drop(node) end
@@ -83,13 +95,15 @@ function nvim_tree.api.node.open.toggle_group_empty(node) end
 ---Open file in a new vertical split.
 ---
 ---@param node? nvim_tree.api.Node file
-function nvim_tree.api.node.open.vertical(node) end
+---@param opts? nvim_tree.api.node.open.Opts optional
+function nvim_tree.api.node.open.vertical(node, opts) end
 
 ---
 ---Open file in a new vertical split without using the window picker.
 ---
 ---@param node? nvim_tree.api.Node file
-function nvim_tree.api.node.open.vertical_no_picker(node) end
+---@param opts? nvim_tree.api.node.open.Opts optional
+function nvim_tree.api.node.open.vertical_no_picker(node, opts) end
 
 ---
 ---@class nvim_tree.api.node.buffer.RemoveOpts

lua/nvim-tree/_meta/config/filters.lua

@@ -3,7 +3,7 @@ error("Cannot require a meta file")
 
 
 
----Filters may be applied to the tree to exlude the display of file/directories.
+---Filters may be applied to the tree to exclude the display of file/directories.
 ---
 ---Multiple filters may be applied at once.
 ---

lua/nvim-tree/actions/node/open-file.lua

@@ -10,10 +10,6 @@ local DirectoryNode = require("nvim-tree.node.directory")
 local FileLinkNode = require("nvim-tree.node.file-link")
 local RootNode = require("nvim-tree.node.root")
 
----@class NodeEditOpts
----@field quit_on_open boolean|nil default false
----@field focus boolean|nil default true
-
 ---@alias NodeOpenFileMode ""|"change_dir"|"drop"|"edit"|"edit_in_place"|"edit_no_picker"|"preview"|"preview_no_picker"|"split"|"split_no_picker"|"tab_drop"|"tabnew"|"toggle_group_empty"|"vsplit"|"vsplit_no_picker"
 
 local M = {}
@@ -416,7 +412,7 @@ end
 
 ---@param mode string
 ---@param node Node
----@param edit_opts NodeEditOpts?
+---@param edit_opts nvim_tree.api.node.open.Opts?
 local function edit(mode, node, edit_opts)
   local file_link = node:as(FileLinkNode)
   local path = file_link and file_link.link_to or node.absolute_path
@@ -432,7 +428,7 @@ local function edit(mode, node, edit_opts)
   end
 
   local mode_unsupported_focus = mode == "drop" or mode == "tab_drop" or mode == "edit_in_place"
-  local focus = edit_opts.focus == nil or edit_opts.focus == true
+  local focus = edit_opts.focus == nil or edit_opts.focus == false
   if not mode_unsupported_focus and not focus then
     -- if mode == "tabnew" a new tab will be opened and we need to focus back to the previous tab
     if mode == "tabnew" then
@@ -445,7 +441,7 @@ end
 ---@param node Node
 ---@param mode NodeOpenFileMode
 ---@param toggle_group boolean?
----@param edit_opts NodeEditOpts?
+---@param edit_opts nvim_tree.api.node.open.Opts?
 local function open_or_expand_or_dir_up(node, mode, toggle_group, edit_opts)
   local root = node:as(RootNode)
   local dir = node:as(DirectoryNode)
@@ -468,18 +464,21 @@ function M.toggle_group_empty(node)
 end
 
 ---@param node Node
-function M.preview(node)
+---@param opts nvim_tree.api.node.open.Opts?
-  open_or_expand_or_dir_up(node, "preview")
+function M.preview(node, opts)
+  open_or_expand_or_dir_up(node, "preview", false, opts)
 end
 
 ---@param node Node
-function M.preview_no_picker(node)
+---@param opts nvim_tree.api.node.open.Opts?
-  open_or_expand_or_dir_up(node, "preview_no_picker")
+function M.preview_no_picker(node, opts)
+  open_or_expand_or_dir_up(node, "preview_no_picker", false, opts)
 end
 
 ---@param node Node
-function M.edit(node)
+---@param opts nvim_tree.api.node.open.Opts?
-  open_or_expand_or_dir_up(node, "edit")
+function M.edit(node, opts)
+  open_or_expand_or_dir_up(node, "edit", false, opts)
 end
 
 ---@param node Node
@@ -498,33 +497,39 @@ function M.replace_tree_buffer(node)
 end
 
 ---@param node Node
-function M.no_window_picker(node)
+---@param opts nvim_tree.api.node.open.Opts?
-  open_or_expand_or_dir_up(node, "edit_no_picker")
+function M.no_window_picker(node, opts)
+  open_or_expand_or_dir_up(node, "edit_no_picker", false, opts)
 end
 
 ---@param node Node
-function M.vertical(node)
+---@param opts nvim_tree.api.node.open.Opts?
-  open_or_expand_or_dir_up(node, "vsplit")
+function M.vertical(node, opts)
+  open_or_expand_or_dir_up(node, "vsplit", false, opts)
 end
 
 ---@param node Node
-function M.vertical_no_picker(node)
+---@param opts nvim_tree.api.node.open.Opts?
-  open_or_expand_or_dir_up(node, "vsplit_no_picker")
+function M.vertical_no_picker(node, opts)
+  open_or_expand_or_dir_up(node, "vsplit_no_picker", false, opts)
 end
 
 ---@param node Node
-function M.horizontal(node)
+---@param opts nvim_tree.api.node.open.Opts?
-  open_or_expand_or_dir_up(node, "split")
+function M.horizontal(node, opts)
+  open_or_expand_or_dir_up(node, "split", false, opts)
 end
 
 ---@param node Node
-function M.horizontal_no_picker(node)
+---@param opts nvim_tree.api.node.open.Opts?
-  open_or_expand_or_dir_up(node, "split_no_picker")
+function M.horizontal_no_picker(node, opts)
+  open_or_expand_or_dir_up(node, "split_no_picker", false, opts)
 end
 
 ---@param node Node
-function M.tab(node)
+---@param opts nvim_tree.api.node.open.Opts?
-  open_or_expand_or_dir_up(node, "tabnew")
+function M.tab(node, opts)
+  open_or_expand_or_dir_up(node, "tabnew", false, opts)
 end
 
 return M

lua/nvim-tree/api/impl.lua

@@ -136,6 +136,11 @@ end
 ---Called explicitly after nvim-tree setup
 ---@param api table not properly typed to prevent LSP from referencing implementations
 function M.hydrate_post_setup(api)
+  -- Parameter naming conventions:
+  --  `e` explorer
+  --  `n` node
+  --  `o` opts
+
   api.config.global                            = __(function() return require("nvim-tree.config").g_clone() end)
   api.config.user                              = __(function() return require("nvim-tree.config").u_clone() end)
 
@@ -182,10 +187,10 @@ function M.hydrate_post_setup(api)
   api.marks.navigate.select                    = e_(function(e) e.marks:navigate_select() end)
   api.marks.toggle                             = ev(function(e, n) e.marks:toggle(n) end)
 
-  api.node.buffer.delete                       = _n(function(n, opts) require("nvim-tree.actions.node.buffer").delete(n, opts) end)
+  api.node.buffer.delete                       = _n(function(n, o) require("nvim-tree.actions.node.buffer").delete(n, o) end)
-  api.node.buffer.wipe                         = _n(function(n, opts) require("nvim-tree.actions.node.buffer").wipe(n, opts) end)
+  api.node.buffer.wipe                         = _n(function(n, o) require("nvim-tree.actions.node.buffer").wipe(n, o) end)
-  api.node.collapse                            = _n(function(n, opts) require("nvim-tree.actions.tree.collapse").node(n, opts) end)
+  api.node.collapse                            = _n(function(n, o) require("nvim-tree.actions.tree.collapse").node(n, o) end)
-  api.node.expand                              = en(function(e, n, opts) e:expand_node(n, opts) end)
+  api.node.expand                              = en(function(e, n, o) e:expand_node(n, o) end)
   api.node.navigate.diagnostics.next           = __(function() require("nvim-tree.actions.moves.item").diagnostics_next() end)
   api.node.navigate.diagnostics.next_recursive = __(function() require("nvim-tree.actions.moves.item").diagnostics_next_recursive() end)
   api.node.navigate.diagnostics.prev           = __(function() require("nvim-tree.actions.moves.item").diagnostics_prev() end)
@@ -205,18 +210,21 @@ function M.hydrate_post_setup(api)
   api.node.navigate.sibling.next               = _n(function(n) require("nvim-tree.actions.moves.sibling").next(n) end)
   api.node.navigate.sibling.prev               = _n(function(n) require("nvim-tree.actions.moves.sibling").prev(n) end)
   api.node.open.drop                           = _n(function(n) require("nvim-tree.actions.node.open-file").drop(n) end)
-  api.node.open.edit                           = _n(function(n) require("nvim-tree.actions.node.open-file").edit(n) end)
+  api.node.open.edit                           = _n(function(n, o) require("nvim-tree.actions.node.open-file").edit(n, o) end)
-  api.node.open.horizontal                     = _n(function(n) require("nvim-tree.actions.node.open-file").horizontal(n) end)
+  api.node.open.horizontal                     = _n(function(n, o) require("nvim-tree.actions.node.open-file").horizontal(n, o) end)
-  api.node.open.horizontal_no_picker           = _n(function(n) require("nvim-tree.actions.node.open-file").horizontal_no_picker(n) end)
+  api.node.open.horizontal_no_picker           = _n(function(n, o)
-  api.node.open.no_window_picker               = _n(function(n) require("nvim-tree.actions.node.open-file").no_window_picker(n) end)
+    require("nvim-tree.actions.node.open-file").horizontal_no_picker(n,
-  api.node.open.preview                        = _n(function(n) require("nvim-tree.actions.node.open-file").preview(n) end)
+      o)
-  api.node.open.preview_no_picker              = _n(function(n) require("nvim-tree.actions.node.open-file").preview_no_picker(n) end)
+  end)
+  api.node.open.no_window_picker               = _n(function(n, o) require("nvim-tree.actions.node.open-file").no_window_picker(n, o) end)
+  api.node.open.preview                        = _n(function(n, o) require("nvim-tree.actions.node.open-file").preview(n, o) end)
+  api.node.open.preview_no_picker              = _n(function(n, o) require("nvim-tree.actions.node.open-file").preview_no_picker(n, o) end)
   api.node.open.replace_tree_buffer            = _n(function(n) require("nvim-tree.actions.node.open-file").replace_tree_buffer(n) end)
-  api.node.open.tab                            = _n(function(n) require("nvim-tree.actions.node.open-file").tab(n) end)
+  api.node.open.tab                            = _n(function(n, o) require("nvim-tree.actions.node.open-file").tab(n, o) end)
   api.node.open.tab_drop                       = _n(function(n) require("nvim-tree.actions.node.open-file").tab_drop(n) end)
   api.node.open.toggle_group_empty             = _n(function(n) require("nvim-tree.actions.node.open-file").toggle_group_empty(n) end)
-  api.node.open.vertical                       = _n(function(n) require("nvim-tree.actions.node.open-file").vertical(n) end)
+  api.node.open.vertical                       = _n(function(n, o) require("nvim-tree.actions.node.open-file").vertical(n, o) end)
-  api.node.open.vertical_no_picker             = _n(function(n) require("nvim-tree.actions.node.open-file").vertical_no_picker(n) end)
+  api.node.open.vertical_no_picker             = _n(function(n, o) require("nvim-tree.actions.node.open-file").vertical_no_picker(n, o) end)
   api.node.run.cmd                             = _n(function(n) require("nvim-tree.actions.node.run-command").run_file_command(n) end)
   api.node.run.system                          = _n(function(n) require("nvim-tree.actions.node.system-open").fn(n) end)
   api.node.show_info_popup                     = _n(function(n) require("nvim-tree.actions.node.file-popup").toggle_file_info(n) end)
@@ -227,22 +235,22 @@ function M.hydrate_post_setup(api)
   api.tree.close                               = __(function() require("nvim-tree.view").close() end)
   api.tree.close_in_all_tabs                   = __(function() require("nvim-tree.view").close_all_tabs() end)
   api.tree.close_in_this_tab                   = __(function() require("nvim-tree.view").close_this_tab_only() end)
-  api.tree.collapse_all                        = __(function(opts) require("nvim-tree.actions.tree.collapse").all(opts) end)
+  api.tree.collapse_all                        = __(function(o) require("nvim-tree.actions.tree.collapse").all(o) end)
-  api.tree.expand_all                          = en(function(e, n, opts) e:expand_all(n, opts) end)
+  api.tree.expand_all                          = en(function(e, n, o) e:expand_all(n, o) end)
-  api.tree.find_file                           = __(function(opts) require("nvim-tree.actions.tree.find-file").fn(opts) end)
+  api.tree.find_file                           = __(function(o) require("nvim-tree.actions.tree.find-file").fn(o) end)
-  api.tree.focus                               = __(function(opts) require("nvim-tree.actions.tree.open").fn(opts) end)
+  api.tree.focus                               = __(function(o) require("nvim-tree.actions.tree.open").fn(o) end)
   api.tree.get_node_under_cursor               = en(function(e) return e:get_node_at_cursor() end)
   api.tree.get_nodes                           = en(function(e) return e:get_nodes() end)
   api.tree.is_tree_buf                         = __(function(bufnr) return require("nvim-tree.utils").is_nvim_tree_buf(bufnr) end)
-  api.tree.is_visible                          = __(function(opts) return require("nvim-tree.view").is_visible(opts) end)
+  api.tree.is_visible                          = __(function(o) return require("nvim-tree.view").is_visible(o) end)
-  api.tree.open                                = __(function(opts) require("nvim-tree.actions.tree.open").fn(opts) end)
+  api.tree.open                                = __(function(o) require("nvim-tree.actions.tree.open").fn(o) end)
   api.tree.reload                              = e_(function(e) e:reload_explorer() end)
   api.tree.reload_git                          = e_(function(e) e:reload_git() end)
-  api.tree.resize                              = __(function(opts) require("nvim-tree.actions.tree.resize").fn(opts) end)
+  api.tree.resize                              = __(function(o) require("nvim-tree.actions.tree.resize").fn(o) end)
   api.tree.search_node                         = __(function() require("nvim-tree.actions.finders.search-node").fn() end)
-  api.tree.toggle                              = __(function(opts) require("nvim-tree.actions.tree.toggle").fn(opts) end)
+  api.tree.toggle                              = __(function(o) require("nvim-tree.actions.tree.toggle").fn(o) end)
   api.tree.toggle_help                         = __(function() require("nvim-tree.help").toggle() end)
-  api.tree.winid                               = __(function(opts) return require("nvim-tree.view").winid(opts) end)
+  api.tree.winid                               = __(function(o) return require("nvim-tree.view").winid(o) end)
 
   -- Map all legacy functions to implementations
   require("nvim-tree.legacy").map_api(api)

lua/nvim-tree/explorer/init.lua

@@ -181,15 +181,30 @@ function Explorer:create_autocmds()
   end
 
   if self.opts.modified.enable then
-    vim.api.nvim_create_autocmd({ "BufModifiedSet", "BufWritePost" }, {
+    local function on_modified_or_buf_write()
-      group = self.augroup_id,
+      utils.debounce("Buf:modified_" .. self.uid_explorer, self.opts.view.debounce_delay, function()
-      callback = function()
+        buffers.reload_modified()
-        utils.debounce("Buf:modified_" .. self.uid_explorer, self.opts.view.debounce_delay, function()
+        self.renderer:draw()
-          buffers.reload_modified()
+      end)
-          self.renderer:draw()
+    end
-        end)
+
-      end,
+    if vim.fn.has("nvim-0.13") == 1 then
-    })
+      vim.api.nvim_create_autocmd({ "OptionSet", }, {
+        group = self.augroup_id,
+        pattern = "modified",
+        callback = on_modified_or_buf_write,
+      })
+      vim.api.nvim_create_autocmd({ "BufWritePost" }, {
+        group = self.augroup_id,
+        callback = on_modified_or_buf_write,
+      })
+    else
+      -- BufModifiedSet event was removed in 0.13: it was a specific case of OptionSet
+      vim.api.nvim_create_autocmd({ "BufModifiedSet", "BufWritePost" }, { ---@diagnostic disable-line: assign-type-mismatch
+        group = self.augroup_id,
+        callback = on_modified_or_buf_write,
+      })
+    end
   end
 end
 

lua/nvim-tree/renderer/components/full-name.lua

@@ -76,6 +76,7 @@ function M.show()
     height    = 1,
     noautocmd = true,
     style     = "minimal",
+    zindex    = 40,
     border    = "none"
   })
   vim.wo[M.popup_win].winhl = view_state.Active.winopts.winhl

scripts/vimdoc.sh

@@ -1,26 +1,17 @@
 #!/usr/bin/env sh
 
-# Wrapper around Nvim make targets:
+# Wrapper around Nvim make doc target:
 #
-# make doc - gen_vimdoc.lua
+# Generates doc/nvim-tree-lua.txt 
-#   Generates doc/nvim-tree-lua.txt 
+# Uses nvim-tree sources defined in scripts/vimdoc_config.lua
-#   Uses nvim-tree sources defined in scripts/vimdoc_config.lua
+# Shims above into src/gen/gen_vimdoc.lua, replacing Nvim's config.
-#   Shims above into src/gen/gen_vimdoc.lua, replacing Nvim's config.
-#
-# make lintdoc - lintdoc.lua
-#   Validates doc/nvim-tree-lua.txt 
-#   Desired:
-#   - tags valid
-#   - links valid
-#   Also:
-#   - brand spelling, notably Nvim and Lua
 #
 # There are some hardcoded expectations which we work around as commented.
 
 set -e
 
-if [ $# -ne 1 ] || [ "${1}" != "doc" ] && [ "${1}" != "lintdoc" ]; then
+if [ $# -ne 1 ] || [ "${1}" != "doc" ]; then
-	echo "usage: ${0} <doc|lintdoc>" 1>&2
+	echo "usage: ${0} <doc>" 1>&2
 	exit 1
 fi
 
@@ -38,7 +29,7 @@ fi
 if [ ! -d "${DIR_NVIM_SRC}" ]; then
 	cat << EOM
 
-Nvim source v0.11+ is required to run ${0}
+Nvim stable source is required to run ${0}
 
 Unavailable: ${DIR_NVIM_SRC_DEF} or \$DIR_NVIM_SRC=${DIR_NVIM_SRC}
 
@@ -84,7 +75,15 @@ if [ "${1}" = "doc" ]; then
 
 	# modify gen_vimdoc.lua to use our config, backing up original
 	cp "${DIR_NVIM_SRC}/src/gen/gen_vimdoc.lua" "${DIR_NVIM_SRC}/src/gen/gen_vimdoc.lua.org"
-	sed -i -E 's/spairs\(config\)/spairs\(require("gen.vimdoc_config")\)/g' "${DIR_NVIM_SRC}/src/gen/gen_vimdoc.lua"
+	sed -i -E '
+
+	# use our config
+	s/spairs\(config\)/spairs\(require("gen.vimdoc_config") --[[injected by nvim-tree]]\)/g ;
+
+	# remove the name linter
+	s/(^run\(\)$)/\n--injected by nvim-tree\nlint.lint_names = function\(\)\nend\n\n\1 --/g
+
+	' "${DIR_NVIM_SRC}/src/gen/gen_vimdoc.lua"
 
 	# leave a generic placeholder to bridge between nvim.gen_vimdoc.Config
 	echo "---@brief placeholder" > "${DIR_NVIM_SRC}/runtime/lua/placeholder.lua"