chore(master): release nvim-tree 1.7.0 (#2910)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -59,9 +59,9 @@ body:
 
         If not provided it is very unlikely that the nvim-tree team will be able to address your issue.
 
-        See [wiki: Clean Room Replication](https://github.com/nvim-tree/nvim-tree.lua/wiki/Troubleshooting#clean-room-replication) for instructions.
+        See [wiki: Clean Room Replication](https://github.com/nvim-tree/nvim-tree.lua/wiki/Troubleshooting#clean-room-replication) for instructions and paste the contents of your `/tmp/nvt-min.lua` here.
 
-        Please paste the contents of your `/tmp/nvt-min.lua` here."
+        Please do NOT post a configuration that uses other plugin managers such as lazy, see [wiki: Lazy Loading](https://github.com/nvim-tree/nvim-tree.lua/wiki/Installation#lazy-loading)"
       render: lua
     validations:
       required: true

.github/workflows/ci.yml

@@ -2,11 +2,9 @@ name: CI
 
 on:
   pull_request:
-    branches:
-      - '*'
   push:
-    branches:
+    branches: [master]
-      - master
+  workflow_dispatch:
 
 permissions:
   contents: read
@@ -14,29 +12,81 @@ permissions:
 jobs:
   lint:
     runs-on: ubuntu-latest
+
+    concurrency:
+      group: ${{ github.workflow }}-${{ matrix.lua_version }}-${{ github.head_ref || github.ref_name }}
+      cancel-in-progress: true
+
+    strategy:
+      matrix:
+        lua_version: [ 5.1 ]
+
     steps:
       - uses: actions/checkout@v4
 
       - uses: leafo/gh-actions-lua@v10
         with:
-          luaVersion: "5.1"
+          luaVersion: ${{ matrix.lua_version }}
 
       - uses: leafo/gh-actions-luarocks@v4
 
-      - name: luacheck
+      - run: luarocks install luacheck 1.1.1
-        run: |
+
-          luarocks install luacheck 1.1.1
+      - run: make lint
-          luacheck lua
 
   style:
     runs-on: ubuntu-latest
+
+    concurrency:
+      group: ${{ github.workflow }}-${{ matrix.stylua_version }}-${{ github.head_ref || github.ref_name }}
+      cancel-in-progress: true
+
+    strategy:
+      matrix:
+        stylua_version: [ 0.19.1 ]
+
     steps:
       - uses: actions/checkout@v4
 
       - name: stylua
-        uses: JohnnyMorganz/stylua-action@v3
+        uses: JohnnyMorganz/stylua-action@v4
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
-          version: "0.19"
+          version: ${{ matrix.stylua_version }}
           args: --check lua
 
+      - run: make style-doc
+
+  check:
+    runs-on: ubuntu-latest
+
+    concurrency:
+      group: ${{ github.workflow }}-${{ matrix.nvim_version }}-${{ matrix.luals_version }}-${{ github.head_ref || github.ref_name }}
+      cancel-in-progress: true
+
+    strategy:
+      matrix:
+        nvim_version: [ stable, nightly ]
+        luals_version: [ 3.10.5 ]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: rhysd/action-setup-vim@v1
+        with:
+          neovim: true
+          version: ${{ matrix.nvim_version }}
+
+      - name: install luals
+        run: |
+          mkdir -p luals
+          curl -L "https://github.com/LuaLS/lua-language-server/releases/download/${{ matrix.luals_version }}/lua-language-server-${{ matrix.luals_version }}-linux-x64.tar.gz" | tar zx --directory luals
+
+      - run: echo "luals/bin" >> "$GITHUB_PATH"
+
+      - name: make check
+        env:
+          VIMRUNTIME: /home/runner/nvim-${{ matrix.nvim_version }}/share/nvim/runtime
+        run: make check
+
+      - run: make help-check

.github/workflows/luarocks-release.yml

@@ -0,0 +1,37 @@
+name: Luarocks Release
+on:
+  push:
+    tags:
+      - 'v[0-9]+.[0-9]+.[0-9]+'
+  workflow_dispatch:
+jobs:
+  luarocks-upload:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: LuaRocks Upload
+        uses: nvim-neorocks/luarocks-tag-release@v7
+        env:
+          LUAROCKS_API_KEY: ${{ secrets.LUAROCKS_API_KEY }}
+        with:
+          summary: A File Explorer For Neovim
+          detailed_description: |
+            Automatic updates
+
+            File type icons
+
+            Git integration
+
+            Diagnostics integration - LSP and COC
+
+            (Live) filtering
+
+            Cut, copy, paste, rename, delete, create etc.
+
+            Highly customisable
+
+            Rich API
+          license: "GPL-3.0"
+          labels: neovim
+          dependencies: |
+            nvim-web-devicons

.github/workflows/release-please.yml

@@ -2,17 +2,20 @@ on:
   push:
     branches:
       - master
+  workflow_dispatch:
+concurrency:
+  group: ${{ github.workflow }}
+  cancel-in-progress: true
 name: release-please
+permissions:
+  contents: write
+  pull-requests: write
 jobs:
   release-please:
     runs-on: ubuntu-latest
     steps:
       - uses: google-github-actions/release-please-action@v4
         id: release
-        with:
-          release-type: simple
-          package-name: nvim-tree
-          command: github-release
       - uses: actions/checkout@v4
       - name: tag major and minor versions
         if: ${{ steps.release.outputs.release_created }}
@@ -20,11 +23,15 @@ jobs:
           git config user.name github-actions[bot]
           git config user.email 41898282+github-actions[bot]@users.noreply.github.com
           git remote add gh-token "https://${{ secrets.GITHUB_TOKEN }}@github.com/google-github-actions/release-please-action.git"
-          git tag -d v${{ steps.release.outputs.major }} || true
+          git tag -d       v${{ steps.release.outputs.major }}                                                                       || true
-          git tag -d v${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }} || true
+          git tag -d       v${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }}                                    || true
-          git push origin :v${{ steps.release.outputs.major }} || true
+          git tag -d       v${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }}.${{ steps.release.outputs.patch }} || true
-          git push origin :v${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }} || true
+          git push origin :v${{ steps.release.outputs.major }}                                                                       || true
-          git tag -a v${{ steps.release.outputs.major }} -m "Release v${{ steps.release.outputs.major }}"
+          git push origin :v${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }}                                    || true
-          git tag -a v${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }} -m "Release v${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }}"
+          git push origin :v${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }}.${{ steps.release.outputs.patch }} || true
-          git push origin v${{ steps.release.outputs.major }}
+          git tag -a       v${{ steps.release.outputs.major }}                                                                       -m "Release v${{ steps.release.outputs.major }}"
-          git push origin v${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }}
+          git tag -a       v${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }}                                    -m "Release v${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }}"
+          git tag -a       v${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }}.${{ steps.release.outputs.patch }} -m "Release v${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }}.${{ steps.release.outputs.patch }}"
+          git push origin  v${{ steps.release.outputs.major }}
+          git push origin  v${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }}
+          git push origin  v${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }}.${{ steps.release.outputs.patch }}

.github/workflows/semantic-pr-subject.yml

@@ -6,10 +6,14 @@ on:
       - reopened
       - edited
       - synchronize
+  workflow_dispatch:
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref }}
+  cancel-in-progress: true
 jobs:
   semantic-pr-subject:
     runs-on: ubuntu-latest
     steps:
-      - uses: amannn/action-semantic-pull-request@v5.4.0
+      - uses: amannn/action-semantic-pull-request@v5.5.3
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -0,0 +1,4 @@
+/luals-out/
+/luals/
+# backup vim files
+*~

.hooks/pre-commit.sh

@@ -1,4 +1,3 @@
-#!/usr/bin/env bash
+#!/bin/sh
 
-stylua . --check || exit 1
+make
-luacheck . || exit 1

.luarc.json

@@ -1,10 +1,15 @@
 {
   "$schema": "https://raw.githubusercontent.com/sumneko/vscode-lua/master/setting/schema.json",
-  "runtime.version" : "Lua 5.1",
+  "runtime.version": "Lua 5.1",
+  "workspace": {
+    "library": [
+      "$VIMRUNTIME/lua/vim",
+      "${3rd}/luv/library"
+    ]
+  },
   "diagnostics": {
-    "globals": [
+    "libraryFiles": "Disable",
-      "vim"
+    "globals": [],
-    ],
     "neededFileStatus": {
       "ambiguity-1": "Any",
       "assign-type-mismatch": "Any",
@@ -26,11 +31,19 @@
       "duplicate-index": "Any",
       "duplicate-set-field": "Any",
       "empty-block": "Any",
+      "global-element": "Any",
       "global-in-nil-env": "Any",
+      "incomplete-signature-doc": "None",
+      "inject-field": "Any",
+      "invisible": "Any",
       "lowercase-global": "Any",
+      "missing-fields": "Any",
+      "missing-global-doc": "Any",
+      "missing-local-export-doc": "None",
       "missing-parameter": "Any",
       "missing-return": "Any",
       "missing-return-value": "Any",
+      "name-style-check": "None",
       "need-check-nil": "Any",
       "newfield-call": "Any",
       "newline-call": "Any",
@@ -63,4 +76,3 @@
     }
   }
 }
-

.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.7.0"
+}

CHANGELOG.md

@@ -1,350 +1,195 @@
 # Changelog
 
-## 1.0.0 (2023-12-09)
+## [1.7.0](https://github.com/nvim-tree/nvim-tree.lua/compare/nvim-tree-v1.6.1...nvim-tree-v1.7.0) (2024-09-21)
 
 
 ### Features
 
-* **#1079:** add renderer.highlight_clipboard default name, defaults to undercurls ([#2410](https://github.com/nvim-tree/nvim-tree.lua/issues/2410)) ([a3aa3b4](https://github.com/nvim-tree/nvim-tree.lua/commit/a3aa3b47eac8b6289f028743bef4ce9eb0f6782e))
+* **#2430:** use vim.ui.open as default system_open, for neovim 0.10+ ([#2912](https://github.com/nvim-tree/nvim-tree.lua/issues/2912)) ([03f737e](https://github.com/nvim-tree/nvim-tree.lua/commit/03f737e5744a2b3ebb4b086f7636a3399224ec0c))
-* **#1245:** add next_diag_item and prev_diag_item actions ([80d4f28](https://github.com/nvim-tree/nvim-tree.lua/commit/80d4f2838353915cc1567f3547d535276af9ab4c))
+* help closes on <Esc> and api.tree.toggle_help mappings ([#2909](https://github.com/nvim-tree/nvim-tree.lua/issues/2909)) ([b652dbd](https://github.com/nvim-tree/nvim-tree.lua/commit/b652dbd0e0489c5fbb81fbededf0d99029cd2f38))
-* **#1389:** add git.show_on_dirs ([#1390](https://github.com/nvim-tree/nvim-tree.lua/issues/1390)) ([736cc84](https://github.com/nvim-tree/nvim-tree.lua/commit/736cc843e1294f7877a1f418860650dcc8e6f1c2))
-* **#1669:** remove deprecated open_on_setup mechanisms ([#2122](https://github.com/nvim-tree/nvim-tree.lua/issues/2122)) ([48d53a5](https://github.com/nvim-tree/nvim-tree.lua/commit/48d53a5934fbd51b655d03db7dad35551838f2c9))
-* **#1804:** add api.marks.bulk.delete with default bd mapping ([#2276](https://github.com/nvim-tree/nvim-tree.lua/issues/2276)) ([bdceaf5](https://github.com/nvim-tree/nvim-tree.lua/commit/bdceaf50966f5f4a2602eb54bfe8a3e52748a42b))
-* **#1837:** add git.disable_for_dirs ([#2239](https://github.com/nvim-tree/nvim-tree.lua/issues/2239)) ([6306140](https://github.com/nvim-tree/nvim-tree.lua/commit/63061404f4686267673707c4baffed740b2cad6a))
-* **#1917:** add diagnostic highlighting and icon placement ([#2396](https://github.com/nvim-tree/nvim-tree.lua/issues/2396)) ([323f65c](https://github.com/nvim-tree/nvim-tree.lua/commit/323f65cb9c6a4eae7a0b15e136fa668aeb7fde9b))
-* **#1974:** enable experimental.git.async by default, see https://github.com/nvim-tree/nvim-tree.lua/issues/2104 ([#2158](https://github.com/nvim-tree/nvim-tree.lua/issues/2158)) ([f8bb6b4](https://github.com/nvim-tree/nvim-tree.lua/commit/f8bb6b4c76e03156fac38c45f9feea84632c65c4))
-* **#1974:** experimental.git.async see https://github.com/nvim-tree/nvim-tree.lua/issues/2104 ([#2094](https://github.com/nvim-tree/nvim-tree.lua/issues/2094)) ([0ef3d46](https://github.com/nvim-tree/nvim-tree.lua/commit/0ef3d4613f90d8e92c1407ddf397b9ee61995526))
-* **#2079:** sort_by may return predefined sort ([#2123](https://github.com/nvim-tree/nvim-tree.lua/issues/2123)) ([6ad5c26](https://github.com/nvim-tree/nvim-tree.lua/commit/6ad5c26f4d44791699c5538d9773cb141ba033e7))
-* **#2092:** add api.node.navigate.open.next, prev ([#2093](https://github.com/nvim-tree/nvim-tree.lua/issues/2093)) ([0c9bfe7](https://github.com/nvim-tree/nvim-tree.lua/commit/0c9bfe7225156c54dd7c79292d6d6468fd1cb2a6))
-* **#2148:** api.fs.rename_full ([#2461](https://github.com/nvim-tree/nvim-tree.lua/issues/2461)) ([0882354](https://github.com/nvim-tree/nvim-tree.lua/commit/08823545171eea269943c7e414cb266abffd0b1b))
-* **#2197:** git and diagnostics folder highlight groups ([#2409](https://github.com/nvim-tree/nvim-tree.lua/issues/2409)) ([b7f6600](https://github.com/nvim-tree/nvim-tree.lua/commit/b7f6600bc2b4e48e4af45f1e77d2bf170685a542))
-* **#2270:** add notify.absolute_path - show file or absolute path (default) names with notifications ([#2286](https://github.com/nvim-tree/nvim-tree.lua/issues/2286)) ([3cc698b](https://github.com/nvim-tree/nvim-tree.lua/commit/3cc698b35b0a67792c61e1726830bb9ecfc4c9f4))
-* **#2277:** skip overwrite prompt when copy/cut paste into same directory ([#2278](https://github.com/nvim-tree/nvim-tree.lua/issues/2278)) ([7aff29d](https://github.com/nvim-tree/nvim-tree.lua/commit/7aff29d755c5b3932af3ea6b69b27df4f3b64bfe))
-* **#2305:** find file refreshes up the tree when node is not present ([#2358](https://github.com/nvim-tree/nvim-tree.lua/issues/2358)) ([ace6422](https://github.com/nvim-tree/nvim-tree.lua/commit/ace64228ad5d89035fbe6f85e7f45a1f7b9e29c1))
-* **#2312:** fire `TextYankPost` event on path copy ([#2489](https://github.com/nvim-tree/nvim-tree.lua/issues/2489)) ([c2194e9](https://github.com/nvim-tree/nvim-tree.lua/commit/c2194e940cf50033bbd05d6a31d8f1b5109bd280))
-* **#2313:** sort_by -> sort.sorter, add sort.folders_first default true ([#2314](https://github.com/nvim-tree/nvim-tree.lua/issues/2314)) ([ef305a8](https://github.com/nvim-tree/nvim-tree.lua/commit/ef305a888be2b9a0627369f00ccebbad88e6e3ce))
-* **#2316:** add NvimTreeFolderArrowClosed NvimTreeFolderArrowOpen ([#2408](https://github.com/nvim-tree/nvim-tree.lua/issues/2408)) ([8f48426](https://github.com/nvim-tree/nvim-tree.lua/commit/8f48426c88cd91aa33610c96ad649f378d7bf718))
-* **#2364:** add option to sort files first ([#2366](https://github.com/nvim-tree/nvim-tree.lua/issues/2366)) ([d11d701](https://github.com/nvim-tree/nvim-tree.lua/commit/d11d701857f4a520a0ee6f4d82d3bef155976be3))
-* **#2369:** add full renderer.icons.web_devicons options for file and folder ([#2375](https://github.com/nvim-tree/nvim-tree.lua/issues/2375)) ([b144b33](https://github.com/nvim-tree/nvim-tree.lua/commit/b144b333901a8429311215c78ee0297aa899b80f))
-* **#2398:** add NvimTreeOpenedFileIcon ([#2407](https://github.com/nvim-tree/nvim-tree.lua/issues/2407)) ([33c3bc5](https://github.com/nvim-tree/nvim-tree.lua/commit/33c3bc562b2ff3c6f5324af94054fc1f21b3c9f7))
-* **#2411:** add renderer.highlight_bookmarks, renderer.icons.bookmarks_placement ([#2412](https://github.com/nvim-tree/nvim-tree.lua/issues/2412)) ([d49a284](https://github.com/nvim-tree/nvim-tree.lua/commit/d49a2842365e425971cd27ae31d73985b0ccc0bc))
-* **#2498:** delete, trash prompts default N, added ui.confirm.default_yes option to override this behaviour ([#2500](https://github.com/nvim-tree/nvim-tree.lua/issues/2500)) ([c156856](https://github.com/nvim-tree/nvim-tree.lua/commit/c1568568b3f58d5cab87cf6a2a84717afe09d11d))
-* **#2515:** add option to change grouped folders name with custom function ([#2521](https://github.com/nvim-tree/nvim-tree.lua/issues/2521)) ([a2aaf8b](https://github.com/nvim-tree/nvim-tree.lua/commit/a2aaf8b430c11af36b869cf1c0ad2f7c8ceeaf2c))
-* **#2530:** keep alt filename on node.open.replace_tree_buffer ([#2531](https://github.com/nvim-tree/nvim-tree.lua/issues/2531)) ([52a1c99](https://github.com/nvim-tree/nvim-tree.lua/commit/52a1c99bf0bedb781ce4817c6ec3ebfe3af90f81))
-* **#2544:** add api.tree.winid ([#2545](https://github.com/nvim-tree/nvim-tree.lua/issues/2545)) ([8c53482](https://github.com/nvim-tree/nvim-tree.lua/commit/8c534822a7d16c83cf69928c53e1d8a13bd2734a))
-* **actions:** expand_all 'exclude' option ([#1388](https://github.com/nvim-tree/nvim-tree.lua/issues/1388)) ([21516f4](https://github.com/nvim-tree/nvim-tree.lua/commit/21516f447baf42f6f11421a017cd69306d5d5ff3))
-* add -bar option to command definitions ([#1422](https://github.com/nvim-tree/nvim-tree.lua/issues/1422)) ([c231933](https://github.com/nvim-tree/nvim-tree.lua/commit/c231933fcdc8855c813f368e48025a368864a636))
-* add actions.open_file.eject ([#2341](https://github.com/nvim-tree/nvim-tree.lua/issues/2341)) ([4bd30f0](https://github.com/nvim-tree/nvim-tree.lua/commit/4bd30f0137e44dcf3e74cc1164efb568f78f2b02))
-* add confirmation kind to select y/n ([ba5c18d](https://github.com/nvim-tree/nvim-tree.lua/commit/ba5c18dc2b43599067d999933469098073e1941c))
-* add cwd arg to open_replacing_current_buffer ([#1348](https://github.com/nvim-tree/nvim-tree.lua/issues/1348)) ([6b7b1b3](https://github.com/nvim-tree/nvim-tree.lua/commit/6b7b1b34fa6c4851a7b06a9ce4a1a703de7fd0ed))
-* add cwd arg to open_replacing_current_buffer: retain existing valid buffer check ([6548287](https://github.com/nvim-tree/nvim-tree.lua/commit/6548287e8b84552d40d28f9e122f7eedf1f331bd))
-* add diagnostics.show_on_open_dirs git.show_on_open_dirs ([#1778](https://github.com/nvim-tree/nvim-tree.lua/issues/1778)) ([829e9f6](https://github.com/nvim-tree/nvim-tree.lua/commit/829e9f68e10a998198e17bf5b348a6947f9d3c2e))
-* add filters.git_ignored (prev git.ignore), apply "Toggle Filter:" prefix to mapping descriptions ([#2325](https://github.com/nvim-tree/nvim-tree.lua/issues/2325)) ([697bfac](https://github.com/nvim-tree/nvim-tree.lua/commit/697bfaccac4a4843449ce7a7b14adb0e7989befe))
-* add NvimTreeCursorLineNr ([#1616](https://github.com/nvim-tree/nvim-tree.lua/issues/1616)) ([7282f7d](https://github.com/nvim-tree/nvim-tree.lua/commit/7282f7de8aedf861fe0162a559fc2b214383c51c))
-* add NvimTreeFindFile!, root_dirs and prefer_startup_root ([b08003f](https://github.com/nvim-tree/nvim-tree.lua/commit/b08003f54640f2015e54dfcd39685862908bfc6a))
-* add NvimTreeNormalFloat ([#2167](https://github.com/nvim-tree/nvim-tree.lua/issues/2167)) ([98b76ff](https://github.com/nvim-tree/nvim-tree.lua/commit/98b76ff0a2f2725b6c0d1b7491ec85ca760c9f3f))
-* add NvimTreeSymlinkIcon ([#2198](https://github.com/nvim-tree/nvim-tree.lua/issues/2198)) ([736c7ff](https://github.com/nvim-tree/nvim-tree.lua/commit/736c7ff59065275f0483af4b7f07a9bc41449ad0))
-* add on_tree_resize event ([c847354](https://github.com/nvim-tree/nvim-tree.lua/commit/c84735483f20b692ffaffb2b889a8956a9a425a4))
-* add option for folder arrows to be inline with indent markers ([#1468](https://github.com/nvim-tree/nvim-tree.lua/issues/1468)) ([7fcb48c](https://github.com/nvim-tree/nvim-tree.lua/commit/7fcb48c852b9d58709169a4dc1ec634fa9ea56f9))
-* add sort_by "filetype" ([#2302](https://github.com/nvim-tree/nvim-tree.lua/issues/2302)) ([3d2fd90](https://github.com/nvim-tree/nvim-tree.lua/commit/3d2fd90b2869f2b4679d540dd0145d002d9688c3))
-* add sort_by "suffix" ([#2307](https://github.com/nvim-tree/nvim-tree.lua/issues/2307)) ([a708bd2](https://github.com/nvim-tree/nvim-tree.lua/commit/a708bd2413d467929b5019ec1bce7b1f428438bc))
-* add ui.confirm.remove and ui.confirm.trash, deprecate trash.require_confirm ([#1887](https://github.com/nvim-tree/nvim-tree.lua/issues/1887)) ([ccb6d8a](https://github.com/nvim-tree/nvim-tree.lua/commit/ccb6d8a518d32e22bf5874f90e6c22661a5d8b46))
-* add winid parameter for api.tree.open, toggle, find_file ([#2213](https://github.com/nvim-tree/nvim-tree.lua/issues/2213)) ([b1e074d](https://github.com/nvim-tree/nvim-tree.lua/commit/b1e074d2b52d45c8327b5b43a498b3d7e6c93b97))
-* allow cycling on git/diagnostic/opened files navigation ([#2506](https://github.com/nvim-tree/nvim-tree.lua/issues/2506)) ([0a99c4a](https://github.com/nvim-tree/nvim-tree.lua/commit/0a99c4a23eae8e25285a30d08439aee8da4f5c16))
-* api.marks.bulk.trash ([#2391](https://github.com/nvim-tree/nvim-tree.lua/issues/2391)) ([7f7665a](https://github.com/nvim-tree/nvim-tree.lua/commit/7f7665a17b60d80533b7a69cfad3b6875f2dd453))
-* api.node.open.preview_no_picker with default mapping <S-Tab> ([#2464](https://github.com/nvim-tree/nvim-tree.lua/issues/2464)) ([aaee4cd](https://github.com/nvim-tree/nvim-tree.lua/commit/aaee4cd896b74f85a81bed7eef2db7869960c4d0))
-* **api:** add `node.open.drop()` ([#2164](https://github.com/nvim-tree/nvim-tree.lua/issues/2164)) ([0df384b](https://github.com/nvim-tree/nvim-tree.lua/commit/0df384b6c0fa62ff1333634d56ee4df0be5d34e1))
-* **api:** add api.commands.get ([#2083](https://github.com/nvim-tree/nvim-tree.lua/issues/2083)) ([45400cd](https://github.com/nvim-tree/nvim-tree.lua/commit/45400cd7e02027937cd5e49845545e606ecf5a1f))
-* **api:** add api.config.mappings.active, api.config.mappings.default ([#1876](https://github.com/nvim-tree/nvim-tree.lua/issues/1876)) ([bac962c](https://github.com/nvim-tree/nvim-tree.lua/commit/bac962caf472a4404ed3ce1ba2fcaf32f8002951))
-* **api:** add api.config.mappings.default_on_attach ([#2037](https://github.com/nvim-tree/nvim-tree.lua/issues/2037)) ([bbb6d48](https://github.com/nvim-tree/nvim-tree.lua/commit/bbb6d4891009de7dab05ad8fc2d39f272d7a751c))
-* **api:** add api.config.mappings.get_keymap and get_keymap_default ([#2056](https://github.com/nvim-tree/nvim-tree.lua/issues/2056)) ([4f03634](https://github.com/nvim-tree/nvim-tree.lua/commit/4f036342f14378b53ac5d7c6ae8d8f6d1bf9a0f8))
-* **api:** add api.fs.clear_clipboard ([#1706](https://github.com/nvim-tree/nvim-tree.lua/issues/1706)) ([cbb5313](https://github.com/nvim-tree/nvim-tree.lua/commit/cbb5313f9044a2ccf0b3e0f85a9e6a4e0fd0dd40))
-* **api:** add api.marks.clear ([#1708](https://github.com/nvim-tree/nvim-tree.lua/issues/1708)) ([cd2f756](https://github.com/nvim-tree/nvim-tree.lua/commit/cd2f7569dbf19ae989fcc0c1906df079b8247797))
-* **api:** add api.tree.get_nodes ([e38e061](https://github.com/nvim-tree/nvim-tree.lua/commit/e38e061710c593d9b88c8ebb2c48f2842c89dc31))
-* **api:** Add new node selection action based on tab :drop command ([#2161](https://github.com/nvim-tree/nvim-tree.lua/issues/2161)) ([d68b00a](https://github.com/nvim-tree/nvim-tree.lua/commit/d68b00a63e98ee02a415e27b3f40cb802b8f1906))
-* **api:** add public API module ([#1432](https://github.com/nvim-tree/nvim-tree.lua/issues/1432)) ([e783278](https://github.com/nvim-tree/nvim-tree.lua/commit/e7832785d2abfc3b8dd67655076eeffddb3141e9))
-* **api:** add tree.is_visible, tree.is_tree_buf ([#2150](https://github.com/nvim-tree/nvim-tree.lua/issues/2150)) ([a774fa1](https://github.com/nvim-tree/nvim-tree.lua/commit/a774fa186c19945d2a594de80922da2cbb4a0139))
-* **api:** api.tree.find_file feature parity with open/toggle, convert all commands to API, document commands ([#2039](https://github.com/nvim-tree/nvim-tree.lua/issues/2039)) ([fe980ba](https://github.com/nvim-tree/nvim-tree.lua/commit/fe980baa945100d92f77fe55e2ca113cae1b1bd3))
-* **api:** api.tree.open feature parity with api.tree.toggle ([#1955](https://github.com/nvim-tree/nvim-tree.lua/issues/1955)) ([215b29b](https://github.com/nvim-tree/nvim-tree.lua/commit/215b29bfad74518442621b9d0483a621483b066b))
-* **api:** api.tree.open/toggle: add current_window option ([#1935](https://github.com/nvim-tree/nvim-tree.lua/issues/1935)) ([f1c2d6d](https://github.com/nvim-tree/nvim-tree.lua/commit/f1c2d6d3723947d822930e66cd4d3351a3c0370a))
-* **api:** rename_basename API and action ([#1791](https://github.com/nvim-tree/nvim-tree.lua/issues/1791)) ([949913f](https://github.com/nvim-tree/nvim-tree.lua/commit/949913f1860eb85024fa1967dbd89ac797777b0d))
-* automated migration from view.mappings.list to on_attach, see https://github.com/nvim-tree/nvim-tree.lua/wiki/Migrating-To-on_attach ([#1579](https://github.com/nvim-tree/nvim-tree.lua/issues/1579)) ([7495975](https://github.com/nvim-tree/nvim-tree.lua/commit/74959750f7823d6e069d3948a645f3c7a4c00638))
-* **bookmarks:** add bookmark feature ([#1412](https://github.com/nvim-tree/nvim-tree.lua/issues/1412)) ([df92f15](https://github.com/nvim-tree/nvim-tree.lua/commit/df92f1527f30d19fbf3474af2badc0636a2d70bf))
-* **copy-paste:** use vim.ui from prompting ([69aec67](https://github.com/nvim-tree/nvim-tree.lua/commit/69aec67edb046aa94c6a2a7aef7ec83bbcfb36b5))
-* **create-file:** use vim.ui.select for confirmation ([1ee6a3e](https://github.com/nvim-tree/nvim-tree.lua/commit/1ee6a3ea65764bee4ca8114652308ee48d789031)), closes [#1434](https://github.com/nvim-tree/nvim-tree.lua/issues/1434) [#1294](https://github.com/nvim-tree/nvim-tree.lua/issues/1294)
-* deprecate view.mappings, see https://github.com/nvim-tree/nvim-tree.lua/wiki/Migrating-To-on_attach ([#2143](https://github.com/nvim-tree/nvim-tree.lua/issues/2143)) ([5aa318c](https://github.com/nvim-tree/nvim-tree.lua/commit/5aa318c15934efa03d2ac86b493e89792e06c7b6))
-* **diagnostics:** add diagnostics.severity ([#1755](https://github.com/nvim-tree/nvim-tree.lua/issues/1755)) ([68a2a09](https://github.com/nvim-tree/nvim-tree.lua/commit/68a2a0971eb50f13e4d54498a2add73f131b9a85))
-* **event:** add au, global: NvimTreeRequired, NvimTreeSetup ([#1912](https://github.com/nvim-tree/nvim-tree.lua/issues/1912)) ([1f0fc8d](https://github.com/nvim-tree/nvim-tree.lua/commit/1f0fc8d6e8c7900533b78b467e37710e9c813ae8))
-* **event:** add TreeAttachedPost ([#1877](https://github.com/nvim-tree/nvim-tree.lua/issues/1877)) ([f43f311](https://github.com/nvim-tree/nvim-tree.lua/commit/f43f3110a570512a4a4ff76a1103d734f02f6b32))
-* **event:** add TreeRendered ([#2324](https://github.com/nvim-tree/nvim-tree.lua/issues/2324)) ([3b62c6b](https://github.com/nvim-tree/nvim-tree.lua/commit/3b62c6bf2c3f2973036aed609d02fd0ca9c3af35))
-* **event:** add WillCreateFile, WillRemoveFile ([#2273](https://github.com/nvim-tree/nvim-tree.lua/issues/2273)) ([c3c6544](https://github.com/nvim-tree/nvim-tree.lua/commit/c3c6544ee00333b0f1d6a13735d0dd302dba4f70))
-* **event:** add WillRenameNode ([#1821](https://github.com/nvim-tree/nvim-tree.lua/issues/1821)) ([a2c7556](https://github.com/nvim-tree/nvim-tree.lua/commit/a2c75567add11a0f76cd61f4dfc86df8cbd4b017))
-* **event:** dispatch Event.NodeRenamed on cut-paste ([#1817](https://github.com/nvim-tree/nvim-tree.lua/issues/1817)) ([e49fa4e](https://github.com/nvim-tree/nvim-tree.lua/commit/e49fa4e52900ddc218cfaa6d7e3345c97a086d40))
-* **file-popup:** add actions.file_popup.open_win_config ([a73d0d4](https://github.com/nvim-tree/nvim-tree.lua/commit/a73d0d4800d517f737d5d6d69283426b48bdf7f3))
-* focus_empty_on_setup ([0417d91](https://github.com/nvim-tree/nvim-tree.lua/commit/0417d9148b6546bf4883b6e9750f992f980afbfe))
-* **git:** add TM git status ([#2045](https://github.com/nvim-tree/nvim-tree.lua/issues/2045)) ([1830e5e](https://github.com/nvim-tree/nvim-tree.lua/commit/1830e5e8a46b32575130bf04bbe0a773999ccb73))
-* **git:** support `DA` state, fix([#1822](https://github.com/nvim-tree/nvim-tree.lua/issues/1822)): test directory capable of watching before presenting it ([#1905](https://github.com/nvim-tree/nvim-tree.lua/issues/1905)) ([3ce0a8e](https://github.com/nvim-tree/nvim-tree.lua/commit/3ce0a8e770f70a135ef969e0a640bd8d05baf42c))
-* **log:** add node inspection function ([#2541](https://github.com/nvim-tree/nvim-tree.lua/issues/2541)) ([5231562](https://github.com/nvim-tree/nvim-tree.lua/commit/5231562cafd7044c827c8b5cfd7b1391894761cc))
-* mapping and options to sort entries in help window ([#2482](https://github.com/nvim-tree/nvim-tree.lua/issues/2482)) ([78a9ca5](https://github.com/nvim-tree/nvim-tree.lua/commit/78a9ca5ed6557f29cd0ce203df44213e54bfabb9))
-* **mapping:** deprecate user mappings and add on_attach ([#1424](https://github.com/nvim-tree/nvim-tree.lua/issues/1424)) ([64cc3c1](https://github.com/nvim-tree/nvim-tree.lua/commit/64cc3c17e1a8d00d0fafcb61349b2a7d57234e53))
-* **marks:** add bulk move action ([#1419](https://github.com/nvim-tree/nvim-tree.lua/issues/1419)) ([26512c3](https://github.com/nvim-tree/nvim-tree.lua/commit/26512c369fdb8b1e2bd80d0039dffac2088f85d8))
-* **marks:** add navigation (next, previous, select) ([#1415](https://github.com/nvim-tree/nvim-tree.lua/issues/1415)) ([89becc7](https://github.com/nvim-tree/nvim-tree.lua/commit/89becc7604719a6d81e7a31e4b4221affa145e89))
-* **movement:** allow circular movement for sibling next and prev ([#1416](https://github.com/nvim-tree/nvim-tree.lua/issues/1416)) ([b32c883](https://github.com/nvim-tree/nvim-tree.lua/commit/b32c88333f8e19685da5f301bb63a30ba685d0cb))
-* notify [NvimTree] prefix is multiline only if the message is multiline ([#2453](https://github.com/nvim-tree/nvim-tree.lua/issues/2453)) ([e64a498](https://github.com/nvim-tree/nvim-tree.lua/commit/e64a498a5eb9169ff9673ef6a409005040d29c4c))
-* **notify:** add notify.threshold ([#1693](https://github.com/nvim-tree/nvim-tree.lua/issues/1693)) ([6ca6f99](https://github.com/nvim-tree/nvim-tree.lua/commit/6ca6f99e7689c68679e8f0a58b421545ff52931f))
-* **notify:** switch all print/nvim_*write statements to utils.notify ([1844713](https://github.com/nvim-tree/nvim-tree.lua/commit/18447132fce62dad87624efdb395fd6b2bebbc35))
-* paste and create always target closed folder, remove create_in_closed_folder ([#1802](https://github.com/nvim-tree/nvim-tree.lua/issues/1802)) ([7177d95](https://github.com/nvim-tree/nvim-tree.lua/commit/7177d95ac0f46bf02ff3f8375e135149a3fc79b8))
-* **picker:** allow custom function actions.open_file.window_picker.picker ([#1782](https://github.com/nvim-tree/nvim-tree.lua/issues/1782)) ([d85b671](https://github.com/nvim-tree/nvim-tree.lua/commit/d85b6718cef7f27c603cf170fb5154d90356e90b))
-* **remove-file:** use vim.ui.select ([2d629ca](https://github.com/nvim-tree/nvim-tree.lua/commit/2d629cab78e6e25374037982531aee95c6e89b10))
-* renderer.full_name includes root node ([#2502](https://github.com/nvim-tree/nvim-tree.lua/issues/2502)) ([7e3c0be](https://github.com/nvim-tree/nvim-tree.lua/commit/7e3c0bee7b246ca835d5f7453db6fa19de359bab))
-* **renderer:** add NvimTreeOpenedFolderIcon NvimTreeClosedFolderIcon ([#1768](https://github.com/nvim-tree/nvim-tree.lua/issues/1768)) ([0b319a1](https://github.com/nvim-tree/nvim-tree.lua/commit/0b319a1b284a2e75faa46107d2cda31a30e946bc))
-* **renderer:** add NvimTreeSymlinkFolderName ([#2000](https://github.com/nvim-tree/nvim-tree.lua/issues/2000)) ([f3dbddf](https://github.com/nvim-tree/nvim-tree.lua/commit/f3dbddf8b3fbd5de7c8838eafc1b3b72cd30c73e))
-* **renderer:** add renderer.indent_width ([#1505](https://github.com/nvim-tree/nvim-tree.lua/issues/1505)) ([e8bf3d7](https://github.com/nvim-tree/nvim-tree.lua/commit/e8bf3d778a74882d748f55d67af206fa8b321d99))
-* **renderer:** add renderer.root_folder_label ([#1746](https://github.com/nvim-tree/nvim-tree.lua/issues/1746)) ([99d7136](https://github.com/nvim-tree/nvim-tree.lua/commit/99d713644d44b573d076812ee5bfcaa5290aaa25))
-* **renderer:** show symlink folder destination ([ad1f3ef](https://github.com/nvim-tree/nvim-tree.lua/commit/ad1f3ef3bc86ca43ebf488569aadf6f56e448575))
-* **search-node:** use vim.ui.input ([1b667bc](https://github.com/nvim-tree/nvim-tree.lua/commit/1b667bc99e1e2cf090362579726fa2a55a4e1acc))
-* **sorters:** allow user sort_by ([3676e0b](https://github.com/nvim-tree/nvim-tree.lua/commit/3676e0b124c2a132857e2bbcf7f48f05228f1052))
-* split startup warning messages into multiple lines ([#2436](https://github.com/nvim-tree/nvim-tree.lua/issues/2436)) ([113e095](https://github.com/nvim-tree/nvim-tree.lua/commit/113e0950c88b81b01d253d8f3da17bbd0e6716bb))
-* support custom $GIT_DIR ([#2263](https://github.com/nvim-tree/nvim-tree.lua/issues/2263)) ([a6daf50](https://github.com/nvim-tree/nvim-tree.lua/commit/a6daf50b9d1aa426f557e51b37ee854b99782d3f))
-* support vim.diagnostic.is_disabled() ([#2232](https://github.com/nvim-tree/nvim-tree.lua/issues/2232)) ([8d82c4d](https://github.com/nvim-tree/nvim-tree.lua/commit/8d82c4dbe15913655b509dcf1179b2ac7c69f9c5))
-* **tab_change:** introduce new option to filter buffer by bufname or ft ([79434c2](https://github.com/nvim-tree/nvim-tree.lua/commit/79434c2b3cd86aebc652db042c17f3b433bfd47c))
-* **tabs:** add tab.sync options ([#1698](https://github.com/nvim-tree/nvim-tree.lua/issues/1698)) ([c494994](https://github.com/nvim-tree/nvim-tree.lua/commit/c49499413a875fc99ce8594cfe6474ed684e51eb))
-* **trash:** add synchronized trash support for windows ([#2335](https://github.com/nvim-tree/nvim-tree.lua/issues/2335)) ([75c0574](https://github.com/nvim-tree/nvim-tree.lua/commit/75c05742bc1f96d9606ee315b3c649973c4fb1cd))
-* **trash:** use vim.ui.select for confirmation ([7cffe14](https://github.com/nvim-tree/nvim-tree.lua/commit/7cffe14743279a7fa05dcd21a09a575e777c55f6))
-* use IEC binary size prefixes ([#2483](https://github.com/nvim-tree/nvim-tree.lua/issues/2483)) ([83b6995](https://github.com/nvim-tree/nvim-tree.lua/commit/83b699533b279af6d207d6c3860d4301556d65b4))
-* use virtual title in notifications if title is not supported ([#2439](https://github.com/nvim-tree/nvim-tree.lua/issues/2439)) ([85abe29](https://github.com/nvim-tree/nvim-tree.lua/commit/85abe2939620fe63b73ec97d3e2e0c7f2ec4fe23))
-* validate all option types ([#2414](https://github.com/nvim-tree/nvim-tree.lua/issues/2414)) ([ea14741](https://github.com/nvim-tree/nvim-tree.lua/commit/ea147418e07e1ca7a867c753c906d27c39863273))
-* validate some option string values ([#2404](https://github.com/nvim-tree/nvim-tree.lua/issues/2404)) ([51f0236](https://github.com/nvim-tree/nvim-tree.lua/commit/51f02366deed1f21153c564b546fed813acfd6d8))
-* **view:** add filters.git_clean, filters.no_buffer ([#1784](https://github.com/nvim-tree/nvim-tree.lua/issues/1784)) ([c5dc80c](https://github.com/nvim-tree/nvim-tree.lua/commit/c5dc80c36b6855cb30bff8e743838b9da97219b3))
-* **view:** add float.quit_on_focus_loss, float respects actions.open_file.quit_on_open ([#1621](https://github.com/nvim-tree/nvim-tree.lua/issues/1621)) ([79f631b](https://github.com/nvim-tree/nvim-tree.lua/commit/79f631bc1d52b387f4ae59fad1291d894afa97f5))
-* **view:** add view.cursorline ([#1859](https://github.com/nvim-tree/nvim-tree.lua/issues/1859)) ([9ad93b6](https://github.com/nvim-tree/nvim-tree.lua/commit/9ad93b6ac062acca6d50563bf3984b287e10f721))
-* **view:** add view.width.min/max replacing adaptive_size, allowing upper bound ([#1915](https://github.com/nvim-tree/nvim-tree.lua/issues/1915)) ([96506fe](https://github.com/nvim-tree/nvim-tree.lua/commit/96506fee49542f3aedab76368d400a147fea344e))
-* **view:** add view.width.padding ([#1941](https://github.com/nvim-tree/nvim-tree.lua/issues/1941)) ([e05ed6a](https://github.com/nvim-tree/nvim-tree.lua/commit/e05ed6a60ff4fa70063f74edbf07ef8365eaabae))
-* **view:** allow function for view.float.open_win_config ([#1538](https://github.com/nvim-tree/nvim-tree.lua/issues/1538)) ([c3ea264](https://github.com/nvim-tree/nvim-tree.lua/commit/c3ea264947671f44d836af5b7587e12c4b4611f9))
-* **view:** always enable cursorline, users may change this behaviour via Event.TreeOpen ([#1814](https://github.com/nvim-tree/nvim-tree.lua/issues/1814)) ([69a07d1](https://github.com/nvim-tree/nvim-tree.lua/commit/69a07d169ae8c1de90904bd5fb9e1dd27eff6d30))
-* **view:** deprecate open_on_setup.* in favour of https://github.com/nvim-tree/nvim-tree.lua/wiki/Open-At-Startup ([#1951](https://github.com/nvim-tree/nvim-tree.lua/issues/1951)) ([fb775b3](https://github.com/nvim-tree/nvim-tree.lua/commit/fb775b335389590f96ba22097b6a36a7c2f161ab))
-* **view:** float.quit_on_focus_loss documentation clarification ([4a01f90](https://github.com/nvim-tree/nvim-tree.lua/commit/4a01f90d111d8a85a79502478f6f4e9ef13df74d))
-* **view:** Floating nvim tree window [#1377](https://github.com/nvim-tree/nvim-tree.lua/issues/1377) ([#1462](https://github.com/nvim-tree/nvim-tree.lua/issues/1462)) ([7323c81](https://github.com/nvim-tree/nvim-tree.lua/commit/7323c81bd6209c247248244b12682cc345630301))
-* **view:** floating window's optional adaptive size specification ([#1559](https://github.com/nvim-tree/nvim-tree.lua/issues/1559)) ([757951b](https://github.com/nvim-tree/nvim-tree.lua/commit/757951ba6b3ee6b0f502c4bd4a23c53b382305c2))
-* **view:** indicate modified buffers ([#1835](https://github.com/nvim-tree/nvim-tree.lua/issues/1835)) ([dcc344c](https://github.com/nvim-tree/nvim-tree.lua/commit/dcc344cc72a617ff01db950aedfd3b3430ba5b59))
-* **watcher:** add filesystem_watchers.ignore_dirs ([#1705](https://github.com/nvim-tree/nvim-tree.lua/issues/1705)) ([ed9db63](https://github.com/nvim-tree/nvim-tree.lua/commit/ed9db632a89ff2712c48e32774d68a715553510f))
-* **watcher:** debounce FS watchers ([e401a4c](https://github.com/nvim-tree/nvim-tree.lua/commit/e401a4c9570f433053604fd9d98833376d5982fe))
-* **watcher:** partial git refresh ([#1373](https://github.com/nvim-tree/nvim-tree.lua/issues/1373)) ([7a795d7](https://github.com/nvim-tree/nvim-tree.lua/commit/7a795d78fa2a102de197e81b85f5b1e6b5f366a3))
-* **watcher:** tear down watcher on failue, warning the user ([#1707](https://github.com/nvim-tree/nvim-tree.lua/issues/1707)) ([a0f3e99](https://github.com/nvim-tree/nvim-tree.lua/commit/a0f3e99b2dc46b441c1a1db09eaf6338f1c5298a))
 
 
 ### Bug Fixes
 
-* **#1270:** ensure explorer exists at startup before propagating FS changes ([55aa006](https://github.com/nvim-tree/nvim-tree.lua/commit/55aa0062b974e1fc29b4462c745271ae40009eda))
+* **#2862:** windows path replaces backslashes with forward slashes ([#2903](https://github.com/nvim-tree/nvim-tree.lua/issues/2903)) ([45a93d9](https://github.com/nvim-tree/nvim-tree.lua/commit/45a93d99794fff3064141d5b3a50db98ce352697))
-* **#1270:** open_on_setup_file does not override open_on_setup, hijack_directories does not override startup behaviour ([#1618](https://github.com/nvim-tree/nvim-tree.lua/issues/1618)) ([c5536db](https://github.com/nvim-tree/nvim-tree.lua/commit/c5536db0b7a9e13709af16a0ffe1ab20137f8a48))
+* **#2906:** resource leak on populate children ([#2907](https://github.com/nvim-tree/nvim-tree.lua/issues/2907)) ([a4dd5ad](https://github.com/nvim-tree/nvim-tree.lua/commit/a4dd5ad5c8f9349142291d24e0e6466995594b9a))
-* **#1354:** add missing :hi NvimTreeFileIgnored ([#1358](https://github.com/nvim-tree/nvim-tree.lua/issues/1358)) ([1fc0eee](https://github.com/nvim-tree/nvim-tree.lua/commit/1fc0eee9465f764bd3c8fab1900efe13318b28c9))
+* **#2917:** fix root copy paths: Y, ge, gy, y ([#2918](https://github.com/nvim-tree/nvim-tree.lua/issues/2918)) ([b18ce8b](https://github.com/nvim-tree/nvim-tree.lua/commit/b18ce8be8f162eee0bc37addcfe17d7d019fcec7))
-* **#1356:** view.close switch_buf_if_last_buf prefers alt buf ([#1357](https://github.com/nvim-tree/nvim-tree.lua/issues/1357)) ([d9aaa2f](https://github.com/nvim-tree/nvim-tree.lua/commit/d9aaa2f985c69ae1452e067e33e8a11ec84196a1))
+* safely close last tree window ([#2913](https://github.com/nvim-tree/nvim-tree.lua/issues/2913)) ([bd48816](https://github.com/nvim-tree/nvim-tree.lua/commit/bd4881660bf0ddfa6acb21259f856ba3dcb26a93))
-* **#1366:** warn when trash cmd missing ([#1378](https://github.com/nvim-tree/nvim-tree.lua/issues/1378)) ([7285898](https://github.com/nvim-tree/nvim-tree.lua/commit/72858986f9de019dc0e151c76090de29954081f0))
+* safely close tree window with pcall and debug logging ([bd48816](https://github.com/nvim-tree/nvim-tree.lua/commit/bd4881660bf0ddfa6acb21259f856ba3dcb26a93))
-* **#1406:** allow nvim-tree.renderer.icons.show.folder_arrow ([fd562ed](https://github.com/nvim-tree/nvim-tree.lua/commit/fd562ede63c6dac8938276f901e1e6d46ac8b293))
+
-* **#1479:** apply remove_keymaps to default mappings ([cfc4692](https://github.com/nvim-tree/nvim-tree.lua/commit/cfc4692a3fd5e5afa7321b878eb8364e7617d7b7))
+## [1.6.1](https://github.com/nvim-tree/nvim-tree.lua/compare/nvim-tree-v1.6.0...nvim-tree-v1.6.1) (2024-09-09)
-* **#1480:** break symlink cycle on find-file, search-node ([#1482](https://github.com/nvim-tree/nvim-tree.lua/issues/1482)) ([261a5c3](https://github.com/nvim-tree/nvim-tree.lua/commit/261a5c380c000e23c4a23dcd55b984c856cdb113))
+
-* **#1484:** better error handling in git utils get_toplevel ([ff6e796](https://github.com/nvim-tree/nvim-tree.lua/commit/ff6e7966f39a897ac4d1358f4d022cfecdc88ff1))
+
-* **#1494:** git showUntracked value and log ([#1504](https://github.com/nvim-tree/nvim-tree.lua/issues/1504)) ([09a5126](https://github.com/nvim-tree/nvim-tree.lua/commit/09a51266bca28dd87febd63c66bdbd74f7764a63))
+### Bug Fixes
-* **#1500:** focusing directories with a trailing slash in their path doesn't work ([#1501](https://github.com/nvim-tree/nvim-tree.lua/issues/1501)) ([b314b3a](https://github.com/nvim-tree/nvim-tree.lua/commit/b314b3a6992f07f7af5c58521d1e219b032d309e))
+
-* **#1503:** focus last win before close ([#1509](https://github.com/nvim-tree/nvim-tree.lua/issues/1509)) ([d9edddb](https://github.com/nvim-tree/nvim-tree.lua/commit/d9edddb84931ca73c350922d76f6c6825b694248))
+* **#2794:** sshfs compatibility ([#2893](https://github.com/nvim-tree/nvim-tree.lua/issues/2893)) ([2d6e64d](https://github.com/nvim-tree/nvim-tree.lua/commit/2d6e64dd8c45a86f312552b7a47eef2c8623a25c))
-* **#1514:** inverted git navigation keymaps ([#1515](https://github.com/nvim-tree/nvim-tree.lua/issues/1515)) ([9fd7b7a](https://github.com/nvim-tree/nvim-tree.lua/commit/9fd7b7ae2920cc349644b5d45785e2a655ffdfe9))
+* **#2868:** windows: do not visit unenumerable directories such as Application Data ([#2874](https://github.com/nvim-tree/nvim-tree.lua/issues/2874)) ([2104786](https://github.com/nvim-tree/nvim-tree.lua/commit/210478677cb9d672c4265deb0e9b59d58b675bd4))
-* **#1518:** sort_by=modification_time not reordering on refresh. ([#1519](https://github.com/nvim-tree/nvim-tree.lua/issues/1519)) ([049cdd3](https://github.com/nvim-tree/nvim-tree.lua/commit/049cdd3073faab064d93f7d6397c9d292d8a3cab))
+* **#2878:** nowrapscan prevents move from root ([#2880](https://github.com/nvim-tree/nvim-tree.lua/issues/2880)) ([4234095](https://github.com/nvim-tree/nvim-tree.lua/commit/42340952af598a08ab80579d067b6da72a9e6d29))
-* **#1520:** file type changes are not detected. ([#1521](https://github.com/nvim-tree/nvim-tree.lua/issues/1521)) ([c5fba1e](https://github.com/nvim-tree/nvim-tree.lua/commit/c5fba1ec1861525a8d2d9773f7983ecf77b588dc))
+* **#2879:** remove unnecessary tree window width setting to prevent unnecessary :wincmd = ([#2881](https://github.com/nvim-tree/nvim-tree.lua/issues/2881)) ([d43ab67](https://github.com/nvim-tree/nvim-tree.lua/commit/d43ab67d0eb4317961c5e9d15fffe908519debe0))
-* **#1529:** ensure tree window exists before closing ([#1537](https://github.com/nvim-tree/nvim-tree.lua/issues/1537)) ([e3353c4](https://github.com/nvim-tree/nvim-tree.lua/commit/e3353c4cb40baef335e1a21d8b9c21b9cde919be))
+
-* **#1533:** make `toggle_mark` ignore non-togglable nodes. ([#1534](https://github.com/nvim-tree/nvim-tree.lua/issues/1534)) ([90dcf42](https://github.com/nvim-tree/nvim-tree.lua/commit/90dcf42bba4b9c07e1d590592035fdec5d8e07d8))
+## [1.6.0](https://github.com/nvim-tree/nvim-tree.lua/compare/nvim-tree-v1.5.0...nvim-tree-v1.6.0) (2024-08-10)
-* **#1539:** Fix closing nvim-tree float when file is removed ([#1546](https://github.com/nvim-tree/nvim-tree.lua/issues/1546)) ([07f59e7](https://github.com/nvim-tree/nvim-tree.lua/commit/07f59e7450c767c674cc53f5930b2d73af60b9c1))
+
-* **#1540:** watcher ignore directories with name exactly '.git' ([259efee](https://github.com/nvim-tree/nvim-tree.lua/commit/259efeee62c7fb51abf299c2570cacbf4806e98a))
+
-* **#1543:** Do not resize nvim-tree window if float is enabled ([#1556](https://github.com/nvim-tree/nvim-tree.lua/issues/1556)) ([ce5d0a6](https://github.com/nvim-tree/nvim-tree.lua/commit/ce5d0a6b7ddfec622554943d2ebcc739b1d74567))
+### Features
-* **#1545:** dispatch Event.Resize on all window resizes, requires nvim 0.9+ ([#2238](https://github.com/nvim-tree/nvim-tree.lua/issues/2238)) ([0345117](https://github.com/nvim-tree/nvim-tree.lua/commit/034511714bacfadc5008e49f73fcef67e5613840))
+
-* **#1547:** pass explicit system arguments to for git toplevel and untracked actions ([9914780](https://github.com/nvim-tree/nvim-tree.lua/commit/9914780cbabdffe3cd030867f0bc34c6e51bcb95))
+* **#2225:** add renderer.hidden_display to show a summary of hidden files below the tree ([#2856](https://github.com/nvim-tree/nvim-tree.lua/issues/2856)) ([e25eb7f](https://github.com/nvim-tree/nvim-tree.lua/commit/e25eb7fa83f7614bb23d762e91d2de44fcd7103b))
-* **#1551:** handle git status TT as staged ([c272c88](https://github.com/nvim-tree/nvim-tree.lua/commit/c272c88dafa5d2e8bf0554f4d687396f843714c5))
+* **#2349:** add "right_align" option for renderer.icons.*_placement ([#2839](https://github.com/nvim-tree/nvim-tree.lua/issues/2839)) ([1d629a5](https://github.com/nvim-tree/nvim-tree.lua/commit/1d629a5d3f7d83d516494c221a2cfc079f43bc47))
-* **#1553:** set correct side on vim open directory ([#1594](https://github.com/nvim-tree/nvim-tree.lua/issues/1594)) ([5cb87c0](https://github.com/nvim-tree/nvim-tree.lua/commit/5cb87c037d92b71a3a6f2bc342e2a38456b8870e))
+* **#2349:** add "right_align" option for renderer.icons.*_placement ([#2846](https://github.com/nvim-tree/nvim-tree.lua/issues/2846)) ([48d0e82](https://github.com/nvim-tree/nvim-tree.lua/commit/48d0e82f9434691cc50d970898142a8c084a49d6))
-* **#1555:** incorrect exe highlight in Windows filesystem from WSL ([#1557](https://github.com/nvim-tree/nvim-tree.lua/issues/1557)) ([4a725c0](https://github.com/nvim-tree/nvim-tree.lua/commit/4a725c0ca501d81002aad77418f1edafdd01a0ba))
+* add renderer.highlight_hidden, renderer.icons.show.hidden and renderer.icons.hidden_placement for dotfile icons/highlights ([#2840](https://github.com/nvim-tree/nvim-tree.lua/issues/2840)) ([48a9290](https://github.com/nvim-tree/nvim-tree.lua/commit/48a92907575df1dbd7242975a04e98169cb3a115))
-* **#1564:** reset &bufhidden when opening an existing (maybe previewed) buffer ([#1573](https://github.com/nvim-tree/nvim-tree.lua/issues/1573)) ([e282420](https://github.com/nvim-tree/nvim-tree.lua/commit/e282420111929e2af2efca6f3fe31f95985d4a5b))
+
-* **#1568:** show relative path of symlink destination ([#1569](https://github.com/nvim-tree/nvim-tree.lua/issues/1569)) ([951e10a](https://github.com/nvim-tree/nvim-tree.lua/commit/951e10a64e0b03069f0f50ddc79d6a8ed8d23dec))
+
-* **#1615:** focus created file when command line prompt requires confirmation ([#1622](https://github.com/nvim-tree/nvim-tree.lua/issues/1622)) ([be2b4f5](https://github.com/nvim-tree/nvim-tree.lua/commit/be2b4f58e66ec48a8597246331c0c76f85171b4d))
+### Bug Fixes
-* **#1626:** obey splitright/below when splitting existing windows ([#1641](https://github.com/nvim-tree/nvim-tree.lua/issues/1641)) ([c4ac723](https://github.com/nvim-tree/nvim-tree.lua/commit/c4ac723a833b6d78b8a6403ad37efd56a67ee0c4))
+
-* **#1628:** quit_on_open e:  do not open in the tree's window ([#1637](https://github.com/nvim-tree/nvim-tree.lua/issues/1637)) ([b01e7be](https://github.com/nvim-tree/nvim-tree.lua/commit/b01e7beaa6f0dbbf5df775cf4ecc829a23f0be54))
+* **#2859:** make sure window still exists when restoring options ([#2863](https://github.com/nvim-tree/nvim-tree.lua/issues/2863)) ([466fbed](https://github.com/nvim-tree/nvim-tree.lua/commit/466fbed3e4b61fcc23a48fe99de7bfa264a9fee8))
-* **#1629:** nvim start with file named *NvimTree* opens tree instead of buffer ([#1634](https://github.com/nvim-tree/nvim-tree.lua/issues/1634)) ([c66cbdf](https://github.com/nvim-tree/nvim-tree.lua/commit/c66cbdfc25ce115db50cfe3dca8b96a8a1e9b931))
+
-* **#1632:** autocenter: avoid use of feedkeys ([#1632](https://github.com/nvim-tree/nvim-tree.lua/issues/1632)) ([187388b](https://github.com/nvim-tree/nvim-tree.lua/commit/187388b7f5ea7b38888c9af9c02cb2f9040aea1f))
+## [1.5.0](https://github.com/nvim-tree/nvim-tree.lua/compare/nvim-tree-v1.4.0...nvim-tree-v1.5.0) (2024-07-11)
-* **#1639:** ensure tree autocommands match filetype as well as name ([#1640](https://github.com/nvim-tree/nvim-tree.lua/issues/1640)) ([48992fd](https://github.com/nvim-tree/nvim-tree.lua/commit/48992fd3e82fa0f2ca22679f909823d8b37171d4))
+
-* **#1643:** preview on floating window ([#1648](https://github.com/nvim-tree/nvim-tree.lua/issues/1648)) ([c995ce0](https://github.com/nvim-tree/nvim-tree.lua/commit/c995ce087875ec5d4df51520b1e9cb09a4b51725))
+
-* **#1664:** respect hijack_directories.enable on startup when not open_on_setup ([#1665](https://github.com/nvim-tree/nvim-tree.lua/issues/1665)) ([4e24505](https://github.com/nvim-tree/nvim-tree.lua/commit/4e24505e2b30c4a8c35a3dfb4f564f14f6d9bfd4))
+### Features
-* **#1668:** revert all startup behaviour changes back to 540055b ([3a2f68b](https://github.com/nvim-tree/nvim-tree.lua/commit/3a2f68b9d53fdf360beba222022868c527ae4d8a))
+
-* **#1668:** update issue link ([2b97063](https://github.com/nvim-tree/nvim-tree.lua/commit/2b970635d1ef531355a380258372411576ecad4d))
+* **#2127:** add experimental.actions.open_file.relative_path to open files with a relative path rather than absolute ([#2805](https://github.com/nvim-tree/nvim-tree.lua/issues/2805)) ([869c064](https://github.com/nvim-tree/nvim-tree.lua/commit/869c064721a6c2091f22c3541e8f0ff958361771))
-* **#1671:** split with no window picker will always find an available window ([#1677](https://github.com/nvim-tree/nvim-tree.lua/issues/1677)) ([dd90bfa](https://github.com/nvim-tree/nvim-tree.lua/commit/dd90bfa155be7fa5371a32cb8b95d4f76d379161))
+* **#2598:** add api.tree.resize ([#2811](https://github.com/nvim-tree/nvim-tree.lua/issues/2811)) ([2ede0de](https://github.com/nvim-tree/nvim-tree.lua/commit/2ede0de67b47e89e2b4cb488ea3f58b8f5a8c90a))
-* **#1675:** open-file sanity check mode ([e94f517](https://github.com/nvim-tree/nvim-tree.lua/commit/e94f5177983c033aad340b5351bf65ef1fa9737a))
+* **#2799:** `filesystem_watchers.ignore_dirs` and `git.disable_for_dirs` may be functions ([#2800](https://github.com/nvim-tree/nvim-tree.lua/issues/2800)) ([8b2c5c6](https://github.com/nvim-tree/nvim-tree.lua/commit/8b2c5c678be4b49dff6a2df794877000113fd77b))
-* **#1679:** renderer.full_name correctly shows for one character outside ([#1688](https://github.com/nvim-tree/nvim-tree.lua/issues/1688)) ([fba9751](https://github.com/nvim-tree/nvim-tree.lua/commit/fba97517bb570702be98718c9f841ae9b359133e))
+* **#2799:** filesystem_watchers.ignore_dirs and git.disable_for_dirs may be functions ([8b2c5c6](https://github.com/nvim-tree/nvim-tree.lua/commit/8b2c5c678be4b49dff6a2df794877000113fd77b))
-* **#1697:** remove notify plugin auto-detection ([#2135](https://github.com/nvim-tree/nvim-tree.lua/issues/2135)) ([68f485b](https://github.com/nvim-tree/nvim-tree.lua/commit/68f485b4542abd3912299b40b9ff39a834365567))
+
-* **#1711:** open in a new window when no window picker and no available window ([#1715](https://github.com/nvim-tree/nvim-tree.lua/issues/1715)) ([33ce8e3](https://github.com/nvim-tree/nvim-tree.lua/commit/33ce8e3c733a9fd949dabb96896eef3e24d01e54))
+
-* **#1712:** invalid window ID on colorscheme ([#1714](https://github.com/nvim-tree/nvim-tree.lua/issues/1714)) ([ada2c64](https://github.com/nvim-tree/nvim-tree.lua/commit/ada2c6441d0844cc1995b5def24fd3e90cfa8032))
+### Bug Fixes
-* **#1716:** focus file/directory when created in a sub-directory, don't dispatch FolderCreated on file creation ([#1722](https://github.com/nvim-tree/nvim-tree.lua/issues/1722)) ([bdc4ec6](https://github.com/nvim-tree/nvim-tree.lua/commit/bdc4ec6abd3e6c78eb5dea5f8b94c2698c3aad51))
+
-* **#1720:** .git watch only FETCH_HEAD, HEAD, HEAD.lock, config, index ([#1732](https://github.com/nvim-tree/nvim-tree.lua/issues/1732)) ([bcb2a5a](https://github.com/nvim-tree/nvim-tree.lua/commit/bcb2a5a80ddfe44dd9f4361800a54baafd7f6f18))
+* **#2813:** macos: enable file renaming with changed capitalization ([#2814](https://github.com/nvim-tree/nvim-tree.lua/issues/2814)) ([abfd1d1](https://github.com/nvim-tree/nvim-tree.lua/commit/abfd1d1b6772540364743531cc0331e08a0027a9))
-* **#1723:** find_file for externally created new file results in folder unable to be opened ([be2ccd4](https://github.com/nvim-tree/nvim-tree.lua/commit/be2ccd4b1a6077b53f8bfabf1e5c1775ca6dfbdc))
+* **#2819:** experimental.actions.open_file.relative_path issue following change directory ([#2820](https://github.com/nvim-tree/nvim-tree.lua/issues/2820)) ([12a9a99](https://github.com/nvim-tree/nvim-tree.lua/commit/12a9a995a455d2c2466e47140663275365a5d2fc))
-* **#1728:** escape cwd changes to prevent environment variable expansion ([#1729](https://github.com/nvim-tree/nvim-tree.lua/issues/1729)) ([e204a7d](https://github.com/nvim-tree/nvim-tree.lua/commit/e204a7d819a9a065d5b1cdc6f59d2d2777d14a0f))
+
-* **#1731 #1723 #1716:** handle all external file system changes ([#1757](https://github.com/nvim-tree/nvim-tree.lua/issues/1757)) ([b17358f](https://github.com/nvim-tree/nvim-tree.lua/commit/b17358ff4d822deeb42b97919065800f8f91cb55))
+## [1.4.0](https://github.com/nvim-tree/nvim-tree.lua/compare/nvim-tree-v1.3.3...nvim-tree-v1.4.0) (2024-06-09)
-* **#1740:** Error while running :NvimTreeCollapseKeepBuffers ([#1741](https://github.com/nvim-tree/nvim-tree.lua/issues/1741)) ([cf90837](https://github.com/nvim-tree/nvim-tree.lua/commit/cf908370fb046641e3aaaa6a6177c1b5d165f186))
+
-* **#1785:** retain focused node on filter toggles ([#2202](https://github.com/nvim-tree/nvim-tree.lua/issues/2202)) ([d5d6950](https://github.com/nvim-tree/nvim-tree.lua/commit/d5d6950a0d0cc2692dfce9a1251b42f4da69136f))
+### Notice
-* **#1804:** do not refresh watched nodes that have been destroyed (deleted) ([d949af7](https://github.com/nvim-tree/nvim-tree.lua/commit/d949af7245c04018e0b5ed3409c4e82c1303d2ea))
+
-* **#1815:** don't schedule find_file calls, debounce update_focused_file with 15ms default ([#1820](https://github.com/nvim-tree/nvim-tree.lua/issues/1820)) ([623cecb](https://github.com/nvim-tree/nvim-tree.lua/commit/623cecb809c6ec35b8ddd47a57732ee2c57446f5))
+* Neovim 0.9 is now the minimum supported version; please upgrade to neovim release version 0.9 or 0.10.
-* **#1815:** don't schedule find_file calls, debounce update_focused_file with 15ms default ([#1828](https://github.com/nvim-tree/nvim-tree.lua/issues/1828)) ([87409bb](https://github.com/nvim-tree/nvim-tree.lua/commit/87409bb4afd0093193e1364faa47327fbfdfca87))
+
-* **#1824:** Don't modify jumplist when `edit_in_place`. ([#1825](https://github.com/nvim-tree/nvim-tree.lua/issues/1825)) ([e8ea62c](https://github.com/nvim-tree/nvim-tree.lua/commit/e8ea62c198f6e91197072350c119e8cc8e7f963a))
+### Reverts
-* **#1831:** improve fs_scandir error handling, add profiling ([89c79cb](https://github.com/nvim-tree/nvim-tree.lua/commit/89c79cb33bc4867ccf9ee4810697da76ac59fdba))
+
-* **#1831:** remove error messages that were previously unreachable and add no value ([547db6e](https://github.com/nvim-tree/nvim-tree.lua/commit/547db6e9297ca9b0da95965d1760461b33b44687))
+* **#2781:** "refactor: replace deprecated use of vim.diagnostic.is_disabled()" ([#2784](https://github.com/nvim-tree/nvim-tree.lua/issues/2784)) ([517e4fb](https://github.com/nvim-tree/nvim-tree.lua/commit/517e4fbb9ef3c0986da7047f44b4b91a2400f93c))
-* **#1831:** remove instrumentation ([#1968](https://github.com/nvim-tree/nvim-tree.lua/issues/1968)) ([e0166d1](https://github.com/nvim-tree/nvim-tree.lua/commit/e0166d146923fdf5df9e26b47fc164ef30ccb548))
+
-* **#1831:** remove instrumentation ([#1969](https://github.com/nvim-tree/nvim-tree.lua/issues/1969)) ([7eb33d2](https://github.com/nvim-tree/nvim-tree.lua/commit/7eb33d2a6d5d574a43159da90e0eac2445367393))
+
-* **#1831:** remove windows executable functionality due to occasional vim freeze and performance concerns ([#1868](https://github.com/nvim-tree/nvim-tree.lua/issues/1868)) ([3c4958a](https://github.com/nvim-tree/nvim-tree.lua/commit/3c4958ab3dd0e5fa470fb50b6b9cc6df48229a2e))
+### Miscellaneous Chores
-* **#1833:** do not find file when view is not visible on the current tab ([#1845](https://github.com/nvim-tree/nvim-tree.lua/issues/1845)) ([9e4c395](https://github.com/nvim-tree/nvim-tree.lua/commit/9e4c39572f631bb60ee15cb9d46e1daa9927a45e))
+
-* **#1836:** add view.debounce_delay ([#1871](https://github.com/nvim-tree/nvim-tree.lua/issues/1871)) ([951b6e7](https://github.com/nvim-tree/nvim-tree.lua/commit/951b6e7e55da8aee9566cc0b17c11f9451cec349))
+* release 1.4.0 ([1cac800](https://github.com/nvim-tree/nvim-tree.lua/commit/1cac8005df6da484c97499247754afa59fef92db))
-* **#1841:** do not refresh on buffer events when highlight_opened_files is none ([4fc74ca](https://github.com/nvim-tree/nvim-tree.lua/commit/4fc74ca32157ecb275e62647fbe9cff0b8e9b9c8))
+
-* **#1841:** do not refresh on buffer events when not a file buffer ([#1843](https://github.com/nvim-tree/nvim-tree.lua/issues/1843)) ([e14c289](https://github.com/nvim-tree/nvim-tree.lua/commit/e14c2895b4f36a22001f7773244041c173dcf867))
+## [1.3.3](https://github.com/nvim-tree/nvim-tree.lua/compare/nvim-tree-v1.3.2...nvim-tree-v1.3.3) (2024-05-14)
-* **#1858:** deprecation warning for config.mappings.active and default ([#2084](https://github.com/nvim-tree/nvim-tree.lua/issues/2084)) ([886d852](https://github.com/nvim-tree/nvim-tree.lua/commit/886d852f6e8b73ae0ed6793bb09601b22d1f2fee))
+
-* **#1858:** fire TreeAttachedPost event following on_attach call ([f0a1c6a](https://github.com/nvim-tree/nvim-tree.lua/commit/f0a1c6ae2eeaefcb693dc1a319150c52e64397b0))
+
-* **#1878:** nvim frozen on no name buffer when modified.enable ([#1879](https://github.com/nvim-tree/nvim-tree.lua/issues/1879)) ([cdbd7da](https://github.com/nvim-tree/nvim-tree.lua/commit/cdbd7daf29db09e58a4ddc181c1be91c07184f4e))
+### Bug Fixes
-* **#1916:** suppress EPERM watcher failures on windows ([#1919](https://github.com/nvim-tree/nvim-tree.lua/issues/1919)) ([1b13a49](https://github.com/nvim-tree/nvim-tree.lua/commit/1b13a49f913b58a5f1792ea81c13947a7988db8e))
+
-* **#1923:** handle empty git icons ([#1952](https://github.com/nvim-tree/nvim-tree.lua/issues/1952)) ([8505b6e](https://github.com/nvim-tree/nvim-tree.lua/commit/8505b6ecd828e8fccb00ea59e789999311391210))
+* nil access exception with git integration when changing branches ([#2774](https://github.com/nvim-tree/nvim-tree.lua/issues/2774)) ([340d3a9](https://github.com/nvim-tree/nvim-tree.lua/commit/340d3a9795e06bdd1814228de398cd510f9bfbb0))
-* **#1923:** handle empty git icons ([#1987](https://github.com/nvim-tree/nvim-tree.lua/issues/1987)) ([ba1778e](https://github.com/nvim-tree/nvim-tree.lua/commit/ba1778e061f25814bc5940be886a7f41d7d7736e))
+
-* **#1931:** do not execute git status in git ignored directories ([#2326](https://github.com/nvim-tree/nvim-tree.lua/issues/2326)) ([273c170](https://github.com/nvim-tree/nvim-tree.lua/commit/273c1700eb68c27dce4e518efafc8144fd7ce4ab))
+## [1.3.2](https://github.com/nvim-tree/nvim-tree.lua/compare/nvim-tree-v1.3.1...nvim-tree-v1.3.2) (2024-05-12)
-* **#1940:** NvimTreeFindFileToggle focus tree ([9e87ee2](https://github.com/nvim-tree/nvim-tree.lua/commit/9e87ee2d6e86f37ff09cb74ec7dcf2ac984a01e9))
+
-* **#1942:** nvim-tree window options do not trigger OptionSet event ([#1945](https://github.com/nvim-tree/nvim-tree.lua/issues/1945)) ([55028e3](https://github.com/nvim-tree/nvim-tree.lua/commit/55028e30d7f897711c6469ea93a316f0f12223d4))
+
-* **#1946:** only change vim's global cwd on startup when opening the tree ([#1947](https://github.com/nvim-tree/nvim-tree.lua/issues/1947)) ([8567841](https://github.com/nvim-tree/nvim-tree.lua/commit/8567841b87a664e47118b178190acc364d6730f9))
+### Bug Fixes
-* **#1950:** disable most API until nvim-tree setup has been called ([#2125](https://github.com/nvim-tree/nvim-tree.lua/issues/2125)) ([56cdb58](https://github.com/nvim-tree/nvim-tree.lua/commit/56cdb5827d7c79611ccbe10ae6a720ee11fbde65))
+
-* **#1961:** cycle detection on refresh, preventing infinite loop ([#1996](https://github.com/nvim-tree/nvim-tree.lua/issues/1996)) ([4222bb8](https://github.com/nvim-tree/nvim-tree.lua/commit/4222bb875d86a2a53069c75c4833e27f58e26d90))
+* **#2758:** use nvim-webdevicons default file icon, not renderer.icons.glyphs.default, as per :help ([#2759](https://github.com/nvim-tree/nvim-tree.lua/issues/2759)) ([347e1eb](https://github.com/nvim-tree/nvim-tree.lua/commit/347e1eb35264677f66a79466bb5e3d111968e12c))
-* **#1961:** harden profiling functions ([#1986](https://github.com/nvim-tree/nvim-tree.lua/issues/1986)) ([b712b82](https://github.com/nvim-tree/nvim-tree.lua/commit/b712b82b0ca4eb402ced2d83f8082366989e43e0))
+* **#2758:** use nvim-webdevicons default for default files ([347e1eb](https://github.com/nvim-tree/nvim-tree.lua/commit/347e1eb35264677f66a79466bb5e3d111968e12c))
-* **#1961:** stop unnecessary find file refreshes, avoid find file refresh cycles ([#2010](https://github.com/nvim-tree/nvim-tree.lua/issues/2010)) ([9c97e64](https://github.com/nvim-tree/nvim-tree.lua/commit/9c97e6449b0b0269bd44e1fd4857184dfa57bb4c))
+* **#925:** handle newlines in file names ([#2754](https://github.com/nvim-tree/nvim-tree.lua/issues/2754)) ([64f61e4](https://github.com/nvim-tree/nvim-tree.lua/commit/64f61e4c913047a045ff90bd188dd3b54ee443cf))
-* **#1970:** additional log function gating for efficiency when not logging ([#1971](https://github.com/nvim-tree/nvim-tree.lua/issues/1971)) ([02fdc26](https://github.com/nvim-tree/nvim-tree.lua/commit/02fdc262eba188198a7deb2117b3b996e6763d65))
+
-* **#1970:** disable git integration after 5 timeouts ([#1990](https://github.com/nvim-tree/nvim-tree.lua/issues/1990)) ([36e29c3](https://github.com/nvim-tree/nvim-tree.lua/commit/36e29c3a95ae606449f6616a0d8ab7247af807dc))
+## [1.3.1](https://github.com/nvim-tree/nvim-tree.lua/compare/nvim-tree-v1.3.0...nvim-tree-v1.3.1) (2024-04-25)
-* **#1976:** support non-standard `$GIT_DIR` ([#2012](https://github.com/nvim-tree/nvim-tree.lua/issues/2012)) ([517dee6](https://github.com/nvim-tree/nvim-tree.lua/commit/517dee64c150821efdc1d5adcd4285fdf9c30371))
+
-* **#1989:** cut/paste over open buffer ([#2279](https://github.com/nvim-tree/nvim-tree.lua/issues/2279)) ([4af5722](https://github.com/nvim-tree/nvim-tree.lua/commit/4af572246ce49883e2a52c49203a19984454f2e0))
+
-* **#1993:** always fire TreeOpen event ([#1994](https://github.com/nvim-tree/nvim-tree.lua/issues/1994)) ([8b8d457](https://github.com/nvim-tree/nvim-tree.lua/commit/8b8d457e07d279976a9baac6bbff5aa036afdc5f))
+### Bug Fixes
-* **#2003:** obey user split command for modified buffers when hidden not set ([#2008](https://github.com/nvim-tree/nvim-tree.lua/issues/2008)) ([04f99f1](https://github.com/nvim-tree/nvim-tree.lua/commit/04f99f14b5f662df722badf78c3cae7b17dc4571))
+
-* **#2004:** relative path detection handles regex magic ([#2005](https://github.com/nvim-tree/nvim-tree.lua/issues/2005)) ([66c15af](https://github.com/nvim-tree/nvim-tree.lua/commit/66c15afd13da5f86de52b82f38cd9d3f418d0dc3))
+* **#2535:** TextYankPost event sends vim.v.event ([#2734](https://github.com/nvim-tree/nvim-tree.lua/issues/2734)) ([d8d3a15](https://github.com/nvim-tree/nvim-tree.lua/commit/d8d3a1590a05b2d8b5eb26e2ed1c6052b1b47a77))
-* **#2024:** help handles empty mapping description ([59bcb01](https://github.com/nvim-tree/nvim-tree.lua/commit/59bcb01d3bf58b810b9c48db56e558f3857110ad))
+* **#2733:** escape trash path ([#2735](https://github.com/nvim-tree/nvim-tree.lua/issues/2735)) ([81eb8d5](https://github.com/nvim-tree/nvim-tree.lua/commit/81eb8d519233c105f30dc0a278607e62b20502fd))
-* **#2024:** revert removal of deprecated nvim-tree.config nvim_tree_callback ([362ecbe](https://github.com/nvim-tree/nvim-tree.lua/commit/362ecbeed69fae91a287004619decadcb6f7c113))
+
-* **#2057:** update focused file on new terminal ([#2060](https://github.com/nvim-tree/nvim-tree.lua/issues/2060)) ([31d8e24](https://github.com/nvim-tree/nvim-tree.lua/commit/31d8e2446025f619bbabe5289815a9f464a2d144))
+## [1.3.0](https://github.com/nvim-tree/nvim-tree.lua/compare/nvim-tree-v1.2.0...nvim-tree-v1.3.0) (2024-03-30)
-* **#2078:** :NvimTreeFindFile focuses tree ([#2080](https://github.com/nvim-tree/nvim-tree.lua/issues/2080)) ([6319ad9](https://github.com/nvim-tree/nvim-tree.lua/commit/6319ad94050c4489951ad34b6535c134a3efa455))
+
-* **#2081:** do not change root for inexistent files ([#2082](https://github.com/nvim-tree/nvim-tree.lua/issues/2082)) ([6515a1e](https://github.com/nvim-tree/nvim-tree.lua/commit/6515a1e1a9c0187e4fa81998a02732bf681a9103))
+
-* **#2086:** "Rename: Omit Filename" not removing file name ([#2087](https://github.com/nvim-tree/nvim-tree.lua/issues/2087)) ([a38f9a5](https://github.com/nvim-tree/nvim-tree.lua/commit/a38f9a55a4b55b0aa18af7abfde2c17a30959bdf))
+### Features
-* **#2088:** actions change dir enable false does not update tree root ([#2095](https://github.com/nvim-tree/nvim-tree.lua/issues/2095)) ([3e9509e](https://github.com/nvim-tree/nvim-tree.lua/commit/3e9509ec1b86f2352af85dd87ed77200488471b6))
+
-* **#2104:** remove experimental.git.async, always used ([#2234](https://github.com/nvim-tree/nvim-tree.lua/issues/2234)) ([164eb10](https://github.com/nvim-tree/nvim-tree.lua/commit/164eb10cbd7363cbedbad768be0f98e8595c322d))
+* add update_focused_file.exclude  ([#2673](https://github.com/nvim-tree/nvim-tree.lua/issues/2673)) ([e20966a](https://github.com/nvim-tree/nvim-tree.lua/commit/e20966ae558524f8d6f93dc37f5d2a8605f893e2))
-* **#2109:** floating help window ([#2120](https://github.com/nvim-tree/nvim-tree.lua/issues/2120)) ([0a144ba](https://github.com/nvim-tree/nvim-tree.lua/commit/0a144ba50af3ef585d3d5170efea64f3d465219c))
+
-* **#2114:** remove deprecated non-API from lib, events ([#2121](https://github.com/nvim-tree/nvim-tree.lua/issues/2121)) ([920d5c8](https://github.com/nvim-tree/nvim-tree.lua/commit/920d5c8f7e4afebfc8e9a25ab36f7da915908838))
+
-* **#2126:** custom window pickers may create windows ([#2140](https://github.com/nvim-tree/nvim-tree.lua/issues/2140)) ([8f392fa](https://github.com/nvim-tree/nvim-tree.lua/commit/8f392fa763b7ee80a48c714b630acaf6d1fe1854))
+### Bug Fixes
-* **#2132:** focus file after rename and paste ([#2151](https://github.com/nvim-tree/nvim-tree.lua/issues/2151)) ([061a05b](https://github.com/nvim-tree/nvim-tree.lua/commit/061a05bfd91475a1001f2c972e5331b166e2a437))
+
-* **#2133:** harden hide_root_folder deprecation ([#2134](https://github.com/nvim-tree/nvim-tree.lua/issues/2134)) ([b601b5a](https://github.com/nvim-tree/nvim-tree.lua/commit/b601b5aa25627f68d3d73ba9269b49e4f04ce126))
+* **#2658:** change SpellCap groups to reduce confusion: ExecFile->Question, ImageFile->Question, SpecialFile->Title, Symlink->Underlined; add all other highlight groups to :NvimTreeHiTest ([#2732](https://github.com/nvim-tree/nvim-tree.lua/issues/2732)) ([0aca092](https://github.com/nvim-tree/nvim-tree.lua/commit/0aca0920f44b12a8383134bcb52da9faec123608))
-* **#2139:** API functions not passing arguments ([#2141](https://github.com/nvim-tree/nvim-tree.lua/issues/2141)) ([a8a4834](https://github.com/nvim-tree/nvim-tree.lua/commit/a8a4834e1af9fb85710bc1307298a45fae4e561c))
+* bookmark filter shows marked directory children ([#2719](https://github.com/nvim-tree/nvim-tree.lua/issues/2719)) ([2d97059](https://github.com/nvim-tree/nvim-tree.lua/commit/2d97059661c83787372c8c003e743c984ba3ac50))
-* **#2154:** `find_file` doesn't work when `group_empty` option is enabled ([#2100](https://github.com/nvim-tree/nvim-tree.lua/issues/2100)) ([d8b154c](https://github.com/nvim-tree/nvim-tree.lua/commit/d8b154c5f0981886fc2b0f1e52d6172e7fdd13e4))
+
-* **#2154:** selection incorrect after find-file when renderer.group_empty ([#2437](https://github.com/nvim-tree/nvim-tree.lua/issues/2437)) ([d8e495b](https://github.com/nvim-tree/nvim-tree.lua/commit/d8e495b2354058276cad6dd32e3efdd1d02f4da6))
+## [1.2.0](https://github.com/nvim-tree/nvim-tree.lua/compare/nvim-tree-v1.1.1...nvim-tree-v1.2.0) (2024-03-24)
-* **#2157:** use stdpath cache for nvim-tree-on-attach.lua ([#2159](https://github.com/nvim-tree/nvim-tree.lua/issues/2159)) ([13c7146](https://github.com/nvim-tree/nvim-tree.lua/commit/13c714681f44fb712ccc2519030a33c4ad925f3f))
+
-* **#2175:** check number of actions.open_file.window_picker.chars before picking window ([#2177](https://github.com/nvim-tree/nvim-tree.lua/issues/2177)) ([9c60947](https://github.com/nvim-tree/nvim-tree.lua/commit/9c60947926e5fb8a04f9fb8d798a1a7ff9126992))
+
-* **#2191:** edit: disregard floating windows ([#2209](https://github.com/nvim-tree/nvim-tree.lua/issues/2209)) ([89816ac](https://github.com/nvim-tree/nvim-tree.lua/commit/89816ace70642e9d3db0dab3dc68918f8979ec31))
+### Features
-* **#2191:** edit: disregard floating windows ([#2212](https://github.com/nvim-tree/nvim-tree.lua/issues/2212)) ([b657405](https://github.com/nvim-tree/nvim-tree.lua/commit/b6574056b52f18cbb987910c72c30f295a80318b))
+
-* **#2240:** disable watchers following EMFILE ([#2268](https://github.com/nvim-tree/nvim-tree.lua/issues/2268)) ([d4f6d33](https://github.com/nvim-tree/nvim-tree.lua/commit/d4f6d33496ef09018ab96e48e4f4a852d3334caf))
+* add api.tree.toggle_enable_filters ([#2706](https://github.com/nvim-tree/nvim-tree.lua/issues/2706)) ([f7c09bd](https://github.com/nvim-tree/nvim-tree.lua/commit/f7c09bd72e50e1795bd3afb9e2a2b157b4bfb3c3))
-* **#2293:** remove unnecessary git status during find file ([#2294](https://github.com/nvim-tree/nvim-tree.lua/issues/2294)) ([1fe3228](https://github.com/nvim-tree/nvim-tree.lua/commit/1fe32286db79719dd6e52236f82c5b52df3ccaa9))
+
-* **#2301:** do not show git status on grouped dirs when show_on_open_dirs ([#2303](https://github.com/nvim-tree/nvim-tree.lua/issues/2303)) ([d17389c](https://github.com/nvim-tree/nvim-tree.lua/commit/d17389ce53929cf9a1e209727121e4388dc3e013))
+## [1.1.1](https://github.com/nvim-tree/nvim-tree.lua/compare/nvim-tree-v1.1.0...nvim-tree-v1.1.1) (2024-03-15)
-* **#2301:** various git folder status fixes ([#2373](https://github.com/nvim-tree/nvim-tree.lua/issues/2373)) ([4e36850](https://github.com/nvim-tree/nvim-tree.lua/commit/4e36850811e219faf649fa68682c7699ca36007d))
+
-* **#2327:** set parent folder git ignore status following file update ([#2328](https://github.com/nvim-tree/nvim-tree.lua/issues/2328)) ([c1466f9](https://github.com/nvim-tree/nvim-tree.lua/commit/c1466f991a3c4cbf77f44282e3baddd4b7432f8c))
+
-* **#2343:** tree is now correctly abandoned upon an in-place open with eject=false ([#2344](https://github.com/nvim-tree/nvim-tree.lua/issues/2344)) ([0a89dcb](https://github.com/nvim-tree/nvim-tree.lua/commit/0a89dcb464b433d2d7b97a8f15d0b608c718dc13))
+### Bug Fixes
-* **#2352:** windows: escape special filename characters on edit ([#2374](https://github.com/nvim-tree/nvim-tree.lua/issues/2374)) ([7c4c7e4](https://github.com/nvim-tree/nvim-tree.lua/commit/7c4c7e4e984db6ec012b0e3df11791a118d638aa))
+
-* **#2370:** Better "y/N" prompts ([#2377](https://github.com/nvim-tree/nvim-tree.lua/issues/2377)) ([920868d](https://github.com/nvim-tree/nvim-tree.lua/commit/920868dba13466586897a8f40220eca6b2caac41))
+* **#2395:** marks.bulk.move defaults to directory at cursor ([#2688](https://github.com/nvim-tree/nvim-tree.lua/issues/2688)) ([cfea5bd](https://github.com/nvim-tree/nvim-tree.lua/commit/cfea5bd0806aab41bef6014c6cf5a510910ddbdb))
-* **#2382:** git watcher handles worktrees and submodules, via --absolute-git-dir when it is available ([#2389](https://github.com/nvim-tree/nvim-tree.lua/issues/2389)) ([28c3980](https://github.com/nvim-tree/nvim-tree.lua/commit/28c3980b25e50e9ede39df55427151cb11be46f9))
+* **#2705:** change NvimTreeWindowPicker cterm background from Cyan to more visible DarkBlue ([#2708](https://github.com/nvim-tree/nvim-tree.lua/issues/2708)) ([1fd9c98](https://github.com/nvim-tree/nvim-tree.lua/commit/1fd9c98960463d2d5d400916c0633b2df016941d))
-* **#2386:** kill git zombies ([#2401](https://github.com/nvim-tree/nvim-tree.lua/issues/2401)) ([5897b36](https://github.com/nvim-tree/nvim-tree.lua/commit/5897b3622f033b1f3ea6adf8eb1c165e9f20554f))
+* bookmark filter should include parent directory ([#2704](https://github.com/nvim-tree/nvim-tree.lua/issues/2704)) ([76b9810](https://github.com/nvim-tree/nvim-tree.lua/commit/76b98109f62caa12b2f1dff472060b2233ea2e90))
-* **#2392:** bookmarks icon placement when group_empty ([#2402](https://github.com/nvim-tree/nvim-tree.lua/issues/2402)) ([b856d0a](https://github.com/nvim-tree/nvim-tree.lua/commit/b856d0a0c3238e49d6385d830ea8c7785b1eccc8))
+
-* **#2440:** `view.width.padding` may be a number or function returning a number ([#2442](https://github.com/nvim-tree/nvim-tree.lua/issues/2442)) ([e153d9f](https://github.com/nvim-tree/nvim-tree.lua/commit/e153d9f5991ef275df46161a5100949847229538))
+## [1.1.0](https://github.com/nvim-tree/nvim-tree.lua/compare/nvim-tree-v1.0.0...nvim-tree-v1.1.0) (2024-03-14)
-* **#2450:** apply NvimTreeImageFile for webp and jxl files ([#2451](https://github.com/nvim-tree/nvim-tree.lua/issues/2451)) ([94e572e](https://github.com/nvim-tree/nvim-tree.lua/commit/94e572e14190c47378f3afe9b60865ace7fa933e))
+
-* **#2459:** disable cygwin git support by default, see :help nvim-tree.git.cygwin_support to enable ([#2486](https://github.com/nvim-tree/nvim-tree.lua/issues/2486)) ([db8145c](https://github.com/nvim-tree/nvim-tree.lua/commit/db8145c27d7a1489b5a0d4fcdd6291d0fbd55a09))
+
-* **#2467:** remove newline in git paths when using cygwin_support ([#2478](https://github.com/nvim-tree/nvim-tree.lua/issues/2478)) ([7c5c074](https://github.com/nvim-tree/nvim-tree.lua/commit/7c5c0743541e8ffb8874fee732adcc400fa652f4))
+### Features
-* **#2468:** always apply filters to subdirectories ([#2537](https://github.com/nvim-tree/nvim-tree.lua/issues/2537)) ([fb89297](https://github.com/nvim-tree/nvim-tree.lua/commit/fb892973477e131042d737c9fc822c7c2ace5076))
+
-* **#2473:** remove problematic <S-Tab> default mapping ([#2475](https://github.com/nvim-tree/nvim-tree.lua/issues/2475)) ([40b9b88](https://github.com/nvim-tree/nvim-tree.lua/commit/40b9b887d090d5da89a84689b4ca0304a9649f62))
+* **#2630:** file renames can now create directories ([#2657](https://github.com/nvim-tree/nvim-tree.lua/issues/2657)) ([efafd73](https://github.com/nvim-tree/nvim-tree.lua/commit/efafd73efa9bc8c26282aed563ba0f01c7465b06))
-* **#2495:** skip API action if node == nil ([#2499](https://github.com/nvim-tree/nvim-tree.lua/issues/2499)) ([7630cf4](https://github.com/nvim-tree/nvim-tree.lua/commit/7630cf4a92b69cc22347894c81cc03966b2a7bcf))
+* add api.fs.copy.basename, default mapping ge ([#2698](https://github.com/nvim-tree/nvim-tree.lua/issues/2698)) ([8f2a50f](https://github.com/nvim-tree/nvim-tree.lua/commit/8f2a50f1cd0c64003042364cf317c8788eaa6c8c))
-* **#2507:** icon in message after rename-file ([#2510](https://github.com/nvim-tree/nvim-tree.lua/issues/2510)) ([20a0707](https://github.com/nvim-tree/nvim-tree.lua/commit/20a0707e0ffa301eb7ef682664f37e2955354f7a))
+
-* **#2512:** file creation in empty folder without root_folder_label ([#2514](https://github.com/nvim-tree/nvim-tree.lua/issues/2514)) ([4ee6366](https://github.com/nvim-tree/nvim-tree.lua/commit/4ee6366ff1fc5d66231516ed05beffb50004261b))
+
-* **#2516:** diagnostics icon highlight group matches the documentation: NvimTreeLspDiagnosticsInfo -> Information ([#2518](https://github.com/nvim-tree/nvim-tree.lua/issues/2518)) ([46e1f77](https://github.com/nvim-tree/nvim-tree.lua/commit/46e1f776f0a714099b9160604fbb62fba2540376))
+### Bug Fixes
-* **#2523:** live filter overlay width calculation ([#2524](https://github.com/nvim-tree/nvim-tree.lua/issues/2524)) ([80cfead](https://github.com/nvim-tree/nvim-tree.lua/commit/80cfeadf179d5cba76f0f502c71dbcff1b515cd8))
+
-* **#549:** add more profiling ~tree init ([95ed588](https://github.com/nvim-tree/nvim-tree.lua/commit/95ed5882114ab481e93362aa74c0f3c65dc4aade))
+* **#2695:** git toplevel guard against missing paths ([#2696](https://github.com/nvim-tree/nvim-tree.lua/issues/2696)) ([3c4267e](https://github.com/nvim-tree/nvim-tree.lua/commit/3c4267eb5045fa86b67fe40c0c63d31efc801e77))
-* `api.node.open.preview` should toggle directories ([#2099](https://github.com/nvim-tree/nvim-tree.lua/issues/2099)) ([7ad1c20](https://github.com/nvim-tree/nvim-tree.lua/commit/7ad1c204c4113b5ce4cc9244ff93a406db810a64))
+* searchcount exception on invalid search regex ([#2693](https://github.com/nvim-tree/nvim-tree.lua/issues/2693)) ([041dbd1](https://github.com/nvim-tree/nvim-tree.lua/commit/041dbd18f440207ad161503a384e7c82d575db66))
-* **actions:** change_dir to wrong directory ([#1398](https://github.com/nvim-tree/nvim-tree.lua/issues/1398)) ([269820e](https://github.com/nvim-tree/nvim-tree.lua/commit/269820e800f6652fac3e0ff66a1463121f2f0ff4))
+
-* **actions:** close_node doesn't close for grouped node ([#1385](https://github.com/nvim-tree/nvim-tree.lua/issues/1385)) ([ec09b80](https://github.com/nvim-tree/nvim-tree.lua/commit/ec09b80c7bbf8a34c82b6de5f0a67ff78cbc8ae0))
+## [1.0.0](https://github.com/nvim-tree/nvim-tree.lua/compare/nvim-tree-v0.100.0...nvim-tree-v1.0.0) (2024-02-18)
-* **actions:** create file should defer more to focus ([0fa2ec1](https://github.com/nvim-tree/nvim-tree.lua/commit/0fa2ec1950a5ef20b692781f18ad9185987bb705))
+
-* **actions:** dispatching filter should not match for "live" keyword ([0f96e32](https://github.com/nvim-tree/nvim-tree.lua/commit/0f96e32326a842798b6b8e638a91464521e4ef71)), closes [#1420](https://github.com/nvim-tree/nvim-tree.lua/issues/1420)
+
-* add legacy options safety ([f742b86](https://github.com/nvim-tree/nvim-tree.lua/commit/f742b86852948f11dcca5735d2af17b75dafee5f))
+### Features
-* **api:** copy is a table, copy -> copy.name ([a044818](https://github.com/nvim-tree/nvim-tree.lua/commit/a0448184af1fe374779d103ab0aed47431ab75e8)), closes [#1461](https://github.com/nvim-tree/nvim-tree.lua/issues/1461)
+
-* **api:** use copy.node instead of copy.name ([e95bfbf](https://github.com/nvim-tree/nvim-tree.lua/commit/e95bfbfc2d1c5bd2684c4607e4bc1b27399416e7)), closes [#1461](https://github.com/nvim-tree/nvim-tree.lua/issues/1461)
+* **#2654:** filters.custom may be a function ([#2655](https://github.com/nvim-tree/nvim-tree.lua/issues/2655)) ([4a87b8b](https://github.com/nvim-tree/nvim-tree.lua/commit/4a87b8b46b4a30107971871df3cb7f4c30fdd5d0))
-* **change-dir:** cd command concatenation ([eb6dde4](https://github.com/nvim-tree/nvim-tree.lua/commit/eb6dde4733a27c87b42d74f962e62f33730365c6))
+
-* **ci:** stylua action version number ([43fd138](https://github.com/nvim-tree/nvim-tree.lua/commit/43fd13854423666c53439536892a5fbc4a66044c))
+
-* cleanup live filter scratch buffers ([#2522](https://github.com/nvim-tree/nvim-tree.lua/issues/2522)) ([74ddb8f](https://github.com/nvim-tree/nvim-tree.lua/commit/74ddb8f2bb5d0a0f4952afb4356ed954f18d5e9e))
+### Miscellaneous Chores
-* close view before hijacking current window ([28c4bb0](https://github.com/nvim-tree/nvim-tree.lua/commit/28c4bb01f64a4f806c66781375b47767225ec94c))
+
-* **colorscheme:** update winhl on colorscheme change ([65c2ba8](https://github.com/nvim-tree/nvim-tree.lua/commit/65c2ba895213c3641fc58dd33bc7a44423a6cdbe)), closes [#1696](https://github.com/nvim-tree/nvim-tree.lua/issues/1696)
+* release 1.0.0 ([#2678](https://github.com/nvim-tree/nvim-tree.lua/issues/2678)) ([d16246a](https://github.com/nvim-tree/nvim-tree.lua/commit/d16246a7575538f77e9246520449b99333c469f7))
-* **copy-paste:** fix message on clipboard clear ([#1838](https://github.com/nvim-tree/nvim-tree.lua/issues/1838)) ([e0cfbbb](https://github.com/nvim-tree/nvim-tree.lua/commit/e0cfbbb93dc66ea51a148f206a49e82ae6bb0368))
+
-* count unicode codepoints instead of bytes ([#1445](https://github.com/nvim-tree/nvim-tree.lua/issues/1445)) ([1e3c578](https://github.com/nvim-tree/nvim-tree.lua/commit/1e3c578eebc854029a7bd6d67dd20a67e3edc38b))
+## [0.100.0](https://github.com/nvim-tree/nvim-tree.lua/compare/nvim-tree-v0.99.0...nvim-tree-v0.100.0) (2024-02-11)
-* **create-file:** pass file in parameter ([1018a83](https://github.com/nvim-tree/nvim-tree.lua/commit/1018a83e10c112efc38b11123d74f9f6c9ea16b6))
+
-* **create-file:** when node is nil, create the file at root ([e632ac7](https://github.com/nvim-tree/nvim-tree.lua/commit/e632ac7c8116ed0ed2e865b4b3e0a17a78de8081)), closes [#1467](https://github.com/nvim-tree/nvim-tree.lua/issues/1467)
+
-* **diagnostics:** coc obey diagnostics.severity ([#2072](https://github.com/nvim-tree/nvim-tree.lua/issues/2072)) ([874b7be](https://github.com/nvim-tree/nvim-tree.lua/commit/874b7be5d053f1b31f545099d6fcbe8ae81e9e03))
+### Features
-* **diagnostics:** do not show on file/dir with same prefix ([fee6801](https://github.com/nvim-tree/nvim-tree.lua/commit/fee68013931b1a208118498d8f7f77858c5f26e0))
+
-* **diagnostics:** do not show on file/dir with same prefix ([#1832](https://github.com/nvim-tree/nvim-tree.lua/issues/1832)) ([3000797](https://github.com/nvim-tree/nvim-tree.lua/commit/3000797e53bab88b9e427655c6164ad1216f68be))
+* **#1389:** api: recursive node navigation for git and diagnostics ([#2525](https://github.com/nvim-tree/nvim-tree.lua/issues/2525)) ([5d13cc8](https://github.com/nvim-tree/nvim-tree.lua/commit/5d13cc8205bce4963866f73c50f6fdc18a515ffe))
-* **dispatch:** dispatch help toggle when its not shown ([95c57e0](https://github.com/nvim-tree/nvim-tree.lua/commit/95c57e034a1921dc1e0dab2f43f8ff87596e0979)), closes [#1411](https://github.com/nvim-tree/nvim-tree.lua/issues/1411)
+* **#2415:** add :NvimTreeHiTest ([#2664](https://github.com/nvim-tree/nvim-tree.lua/issues/2664)) ([b278fc2](https://github.com/nvim-tree/nvim-tree.lua/commit/b278fc25ae0fc95e4808eb5618f07fc2522fd2b3))
-* **doc:** duplicate help tag in README ([#2066](https://github.com/nvim-tree/nvim-tree.lua/issues/2066)) ([a50723e](https://github.com/nvim-tree/nvim-tree.lua/commit/a50723e35f57f89fb67019127a16d90f16edfef8))
+* **#2415:** colour and highlight overhaul, see :help nvim-tree-highlight-overhaul ([#2455](https://github.com/nvim-tree/nvim-tree.lua/issues/2455)) ([e9c5abe](https://github.com/nvim-tree/nvim-tree.lua/commit/e9c5abe073a973f54d3ca10bfe30f253569f4405))
-* **docs:** typos ([#1470](https://github.com/nvim-tree/nvim-tree.lua/issues/1470)) ([2928f8f](https://github.com/nvim-tree/nvim-tree.lua/commit/2928f8fe31bacc287a988e02b7fe930f19c6a972))
+* add node.open.toggle_group_empty, default mapping L ([#2647](https://github.com/nvim-tree/nvim-tree.lua/issues/2647)) ([8cbb1db](https://github.com/nvim-tree/nvim-tree.lua/commit/8cbb1db8e90b62fc56f379992e622e9f919792ce))
-* ensure startup warnings are visible with a multiline message, to work around https://github.com/neovim/neovim/issues/17832 planned for fix in nvim 0.10 ([#2387](https://github.com/nvim-tree/nvim-tree.lua/issues/2387)) ([807dc05](https://github.com/nvim-tree/nvim-tree.lua/commit/807dc051560afda30956320ed718def878f655f0))
+
-* error when deleting opened file from floating window ([#2503](https://github.com/nvim-tree/nvim-tree.lua/issues/2503)) ([24bb0ed](https://github.com/nvim-tree/nvim-tree.lua/commit/24bb0ed806f0984906fc65940b31cd0107229946))
+
-* **executable:** prevent nil extensions in executable check ([630305c](https://github.com/nvim-tree/nvim-tree.lua/commit/630305c233b815464d57bc253444610eb327d255)), closes [#1444](https://github.com/nvim-tree/nvim-tree.lua/issues/1444)
+### Bug Fixes
-* expand and collapse whole folder groups ([#2380](https://github.com/nvim-tree/nvim-tree.lua/issues/2380)) ([0074120](https://github.com/nvim-tree/nvim-tree.lua/commit/00741206c2df9c4b538055def19b99790f0c95c8))
+
-* **explorer:** reload `executable` stat ([#1427](https://github.com/nvim-tree/nvim-tree.lua/issues/1427)) ([b754eb8](https://github.com/nvim-tree/nvim-tree.lua/commit/b754eb8359837900044ea414d2edeff495e6bdb1))
+* **#2415:** disambiguate highlight groups, see :help nvim-tree-highlight-overhaul ([#2639](https://github.com/nvim-tree/nvim-tree.lua/issues/2639)) ([d9cb432](https://github.com/nvim-tree/nvim-tree.lua/commit/d9cb432d2c8d8fa9267ddbd7535d76fe4df89360))
-* **file rename:** edit buffer when renaming to reset filetype ([90bf140](https://github.com/nvim-tree/nvim-tree.lua/commit/90bf14014e8b31c1a96c23a9583bf89028da13e2))
+* **#2415:** fix NvimTreeIndentMarker highlight group: FileIcon->FolderIcon ([e9ac136](https://github.com/nvim-tree/nvim-tree.lua/commit/e9ac136a3ab996aa8e4253253521dcf2cb66b81b))
-* **find-file:** do not recurse on closed nodes ([9d3602e](https://github.com/nvim-tree/nvim-tree.lua/commit/9d3602e8eab27ffb88cb89f2a938a127acd86c42))
+* **#2415:** highlight help header and mappings ([#2669](https://github.com/nvim-tree/nvim-tree.lua/issues/2669)) ([39e6fef](https://github.com/nvim-tree/nvim-tree.lua/commit/39e6fef85ac3bb29532b877aa7c9c34911c661af))
-* focus visible parent on collapse all ([#2261](https://github.com/nvim-tree/nvim-tree.lua/issues/2261)) ([f873625](https://github.com/nvim-tree/nvim-tree.lua/commit/f873625d0636889af4cd47a01e486beb865db205))
+* **#2415:** nvim 0.8 highlight overhaul support, limited to only show highest highlight precedence ([#2642](https://github.com/nvim-tree/nvim-tree.lua/issues/2642)) ([f39f7b6](https://github.com/nvim-tree/nvim-tree.lua/commit/f39f7b6fcd3865ac2146de4cb4045286308f2935))
-* fs_watcher not started for .git folders (windows) ([#2265](https://github.com/nvim-tree/nvim-tree.lua/issues/2265)) ([f5804ce](https://github.com/nvim-tree/nvim-tree.lua/commit/f5804ce94e06966e0fc1aba9c697c178fc7cb210))
+* **#2415:** NvimTreeIndentMarker highlight group: FileIcon->FolderIcon ([#2656](https://github.com/nvim-tree/nvim-tree.lua/issues/2656)) ([e9ac136](https://github.com/nvim-tree/nvim-tree.lua/commit/e9ac136a3ab996aa8e4253253521dcf2cb66b81b))
-* **fs:** create file failure when reloading watch path for node ([3d58a9b](https://github.com/nvim-tree/nvim-tree.lua/commit/3d58a9b2cfd7146e2f38b101bbc860e4c80a0ceb)), closes [#1633](https://github.com/nvim-tree/nvim-tree.lua/issues/1633)
+* **#2624:** open file from docked floating window ([#2627](https://github.com/nvim-tree/nvim-tree.lua/issues/2627)) ([f24afa2](https://github.com/nvim-tree/nvim-tree.lua/commit/f24afa2cef551122b8bd53bb2e4a7df42343ce2e))
-* **get-node-from-path:** group dirs should be returned before nodes ([4bd919a](https://github.com/nvim-tree/nvim-tree.lua/commit/4bd919a75f37c7127ccfc746fc59a71068db3ceb))
+* **#2632:** occasional error stack when locating nvim-tree window ([#2633](https://github.com/nvim-tree/nvim-tree.lua/issues/2633)) ([48b1d86](https://github.com/nvim-tree/nvim-tree.lua/commit/48b1d8638fa3726236ae22e0e48a74ac8ea6592a))
-* git highlight for new staged files ([#2534](https://github.com/nvim-tree/nvim-tree.lua/issues/2534)) ([8f9169a](https://github.com/nvim-tree/nvim-tree.lua/commit/8f9169a05931041aad1a0719e82eb02cea528881))
+* **#2637:** show buffer modified icons and highlights ([#2638](https://github.com/nvim-tree/nvim-tree.lua/issues/2638)) ([7bdb220](https://github.com/nvim-tree/nvim-tree.lua/commit/7bdb220d0fe604a77361e92cdbc7af1b8a412126))
-* **git:** fix inverted condition logic introduced in [#1433](https://github.com/nvim-tree/nvim-tree.lua/issues/1433) ([#1443](https://github.com/nvim-tree/nvim-tree.lua/issues/1443)) ([c964fa2](https://github.com/nvim-tree/nvim-tree.lua/commit/c964fa24d0e6cc7d77d46e29c03f6f004af1578c))
+* **#2643:** correctly apply linked highlight groups in tree window ([#2653](https://github.com/nvim-tree/nvim-tree.lua/issues/2653)) ([fbee8a6](https://github.com/nvim-tree/nvim-tree.lua/commit/fbee8a69a46f558d29ab84e96301425b0501c668))
-* **git:** git folder fixes and improvements ([#1809](https://github.com/nvim-tree/nvim-tree.lua/issues/1809)) ([29788cc](https://github.com/nvim-tree/nvim-tree.lua/commit/29788cc32a153e42b2fe48344d315da8367fc6fa))
+* allow highlight overrides for DEFAULT_DEFS: NvimTreeFolderIcon, NvimTreeWindowPicker ([#2636](https://github.com/nvim-tree/nvim-tree.lua/issues/2636)) ([74525ac](https://github.com/nvim-tree/nvim-tree.lua/commit/74525ac04760bf0d9fec2bf51474d2b05f36048e))
-* **git:** git rename not showing up for the renamed file ([#1783](https://github.com/nvim-tree/nvim-tree.lua/issues/1783)) ([f8489c9](https://github.com/nvim-tree/nvim-tree.lua/commit/f8489c992998e1e1b45aec65bdb9615e5cd59a61))
+* bad column offset when using full_name ([#2629](https://github.com/nvim-tree/nvim-tree.lua/issues/2629)) ([75ff64e](https://github.com/nvim-tree/nvim-tree.lua/commit/75ff64e6663fc3b23c72dca32b2f838acefe7c8a))
-* **git:** prevent execution of git commands when git integration is disabled ([#1433](https://github.com/nvim-tree/nvim-tree.lua/issues/1433)) ([203bb7e](https://github.com/nvim-tree/nvim-tree.lua/commit/203bb7e176fc0d00fddceabf12bebfe87bb8da02))
+* passing nil as window handle in view.get_winnr ([48b1d86](https://github.com/nvim-tree/nvim-tree.lua/commit/48b1d8638fa3726236ae22e0e48a74ac8ea6592a))
-* harden git status updates ([#2533](https://github.com/nvim-tree/nvim-tree.lua/issues/2533)) ([633811c](https://github.com/nvim-tree/nvim-tree.lua/commit/633811c53d3b7856cab8e96b91c6a5d2cf9eb8ae))
+
-* harden tree root cwd fetch ([#2557](https://github.com/nvim-tree/nvim-tree.lua/issues/2557)) ([5e4475d](https://github.com/nvim-tree/nvim-tree.lua/commit/5e4475d8bf7a3646164e01d9b65ef68369b17e3c))
+## 0.99.0 (2024-01-01)
-* help window header is minimum width ([#2149](https://github.com/nvim-tree/nvim-tree.lua/issues/2149)) ([5b53732](https://github.com/nvim-tree/nvim-tree.lua/commit/5b5373254f572de1fb65a7046fbd61bbffe6da05))
+
-* **help:** clear git signs before draw ([b81ab19](https://github.com/nvim-tree/nvim-tree.lua/commit/b81ab199a513f0c5c099f7be3f230ce796f5ad12))
+
-* Implicit current buf on centralize selection ([#1792](https://github.com/nvim-tree/nvim-tree.lua/issues/1792)) ([0cd8ac4](https://github.com/nvim-tree/nvim-tree.lua/commit/0cd8ac4751c39440a1c28c6be4704f3597807d29))
+### Features
-* info size suffix and formatting ([#2492](https://github.com/nvim-tree/nvim-tree.lua/issues/2492)) ([a31dfad](https://github.com/nvim-tree/nvim-tree.lua/commit/a31dfada1d0d177f88bc0b7e27365b08446788bb))
+
-* inverted diagnostic navigation keymaps ([81eb718](https://github.com/nvim-tree/nvim-tree.lua/commit/81eb718394e489d2aebbffa730d2517d72ec7f9c))
+* **#1850:** add "no bookmark" filter ([#2571](https://github.com/nvim-tree/nvim-tree.lua/issues/2571)) ([8f92e1e](https://github.com/nvim-tree/nvim-tree.lua/commit/8f92e1edd399f839a23776dcc6eee4ba18030370))
-* **iterators:** the index does not increase ([#1399](https://github.com/nvim-tree/nvim-tree.lua/issues/1399)) ([418fc97](https://github.com/nvim-tree/nvim-tree.lua/commit/418fc971fc22a501cbc09b5f7425129b7c95130d))
+* add kind param to vim.ui.select function calls ([#2602](https://github.com/nvim-tree/nvim-tree.lua/issues/2602)) ([dc839a7](https://github.com/nvim-tree/nvim-tree.lua/commit/dc839a72a6496ce22ebd3dd959115cf97c1b20a0))
-* **keymaps:** get_keymaps takes remove_keymaps as parameter ([9bbf95e](https://github.com/nvim-tree/nvim-tree.lua/commit/9bbf95e61691feb6696880701cdb1b6cafa97d41))
+* add option to skip gitignored files on git navigation ([#2583](https://github.com/nvim-tree/nvim-tree.lua/issues/2583)) ([50f30bc](https://github.com/nvim-tree/nvim-tree.lua/commit/50f30bcd8c62ac4a83d133d738f268279f2c2ce2))
-* **keypress:** use <cmd> instead of `:` to avoid triggering CmdLineEnter ([7087af8](https://github.com/nvim-tree/nvim-tree.lua/commit/7087af83f3a003913ed280eb3bdffe3a46a601c6)), closes [#1417](https://github.com/nvim-tree/nvim-tree.lua/issues/1417)
+
-* nerd font 3 bookmark icon ([#2203](https://github.com/nvim-tree/nvim-tree.lua/issues/2203)) ([498e879](https://github.com/nvim-tree/nvim-tree.lua/commit/498e8793bbe73ab5235b3ee8f0aee32f5d01649f))
+
-* **notify:** log file notice info->debug ([cc18122](https://github.com/nvim-tree/nvim-tree.lua/commit/cc18122be1c53e6736f4f7a75a32429b3bbca2a0))
+### Bug Fixes
-* **notify:** remove unused varargs, log file notice debug->info ([a65063c](https://github.com/nvim-tree/nvim-tree.lua/commit/a65063cb0a67c0794da9aa6fc8ac0e64f614daf7))
+
-* **open-file:** focus file if already opened ([4900d66](https://github.com/nvim-tree/nvim-tree.lua/commit/4900d66370988108dbe0f57cb8a2fc090878f73d))
+* **#2519:** Diagnostics Not Updated When Tree Not Visible ([#2597](https://github.com/nvim-tree/nvim-tree.lua/issues/2597)) ([96a783f](https://github.com/nvim-tree/nvim-tree.lua/commit/96a783fbd606a458bcce2ef8041240a8b94510ce))
-* **open-file:** vim.op -> vim.opt ([2edbe75](https://github.com/nvim-tree/nvim-tree.lua/commit/2edbe759cd45d4a7a3ae0c6e05f5b54860775f98))
+* **#2609:** help toggle ([#2611](https://github.com/nvim-tree/nvim-tree.lua/issues/2611)) ([fac4900](https://github.com/nvim-tree/nvim-tree.lua/commit/fac4900bd18a9fa15be3d104645d9bdef7b3dcec))
-* **paste:** allow pasting into empty root directory ([1837751](https://github.com/nvim-tree/nvim-tree.lua/commit/1837751efb5fcfc584cb0ee900f09ff911cd6c0b)), closes [#1736](https://github.com/nvim-tree/nvim-tree.lua/issues/1736)
+* hijack_cursor on update focused file and vim search ([#2600](https://github.com/nvim-tree/nvim-tree.lua/issues/2600)) ([02ae523](https://github.com/nvim-tree/nvim-tree.lua/commit/02ae52357ba4da77a4c120390791584a81d15340))
-* **paste:** paste into empty root directory ([059e4ca](https://github.com/nvim-tree/nvim-tree.lua/commit/059e4cadd658229ff7a5f9b56064be87f52cc6cd))
-* **perf:** explorer was creating new table for each new entry ([665813b](https://github.com/nvim-tree/nvim-tree.lua/commit/665813b9e6e247c633346b861e08f03e44e3ac91))
-* prompt uses first character of response - allow "yy" ([#2357](https://github.com/nvim-tree/nvim-tree.lua/issues/2357)) ([904f95c](https://github.com/nvim-tree/nvim-tree.lua/commit/904f95cd9db31d1800998fa428e78e418a50181d))
-* **prompt:** add select_prompts to suit UI decorator plugins such as dressing and telescope ([ac8d259](https://github.com/nvim-tree/nvim-tree.lua/commit/ac8d259badf915cd9aaad406503d116230296c44))
-* reload tree on `BufEnter` if cwd is different ([#2527](https://github.com/nvim-tree/nvim-tree.lua/issues/2527)) ([874ae6e](https://github.com/nvim-tree/nvim-tree.lua/commit/874ae6e9445a5eb5ba430e5fd10212450a261ad7))
-* remove redundant file existence check in create file operation ([#1936](https://github.com/nvim-tree/nvim-tree.lua/issues/1936)) ([16f2806](https://github.com/nvim-tree/nvim-tree.lua/commit/16f2806d5968157fd6f76542c9ac358c684a3a03))
-* remove unnecessary conditions ([#1614](https://github.com/nvim-tree/nvim-tree.lua/issues/1614)) ([45d386a](https://github.com/nvim-tree/nvim-tree.lua/commit/45d386a3591f87390390c0d718a81e05895465ca))
-* **renderer:** indent markers + folder arrows should offset ([8632ac2](https://github.com/nvim-tree/nvim-tree.lua/commit/8632ac273979d5ec22ecee9c23aba18a73345584)), closes [#1421](https://github.com/nvim-tree/nvim-tree.lua/issues/1421)
-* **renderer:** indent markers with arrows ([9a02ded](https://github.com/nvim-tree/nvim-tree.lua/commit/9a02dedd92fad67b04b2a3fee2de20555956b089))
-* **renderer:** padding indent with folders only ([449b5bd](https://github.com/nvim-tree/nvim-tree.lua/commit/449b5bd0cbe08192ded83b2bce8cbec4764da63d))
-* replace vim.* "requires" with explicit calls to vim functions ([#1701](https://github.com/nvim-tree/nvim-tree.lua/issues/1701)) ([8cc3696](https://github.com/nvim-tree/nvim-tree.lua/commit/8cc369695b3a0ae3ddf9538bc1f87bbf8cdbecca))
-* restore eventignore ([#1612](https://github.com/nvim-tree/nvim-tree.lua/issues/1612)) ([11b5248](https://github.com/nvim-tree/nvim-tree.lua/commit/11b524899fc4d9a79e1b5632bd84dcc5b06da3aa))
-* schedule notifications to avoid UI freeze on startup ([#2432](https://github.com/nvim-tree/nvim-tree.lua/issues/2432)) ([ce3495b](https://github.com/nvim-tree/nvim-tree.lua/commit/ce3495bd4c9a7d8e8a64fac9cc3c252dac19a994))
-* **scripts:** default mappings should put a comma at the end of each line ([08ab346](https://github.com/nvim-tree/nvim-tree.lua/commit/08ab346f0312433b3f10a4a10f4b69d98138d38f))
-* sort_by "extension" falls back to name ([#2306](https://github.com/nvim-tree/nvim-tree.lua/issues/2306)) ([04b2c1e](https://github.com/nvim-tree/nvim-tree.lua/commit/04b2c1e08c32cf1620b9404d8417f415b6ec7aad))
-* **styling:** empty line ([4aef454](https://github.com/nvim-tree/nvim-tree.lua/commit/4aef454cd29bc69ae7d6c4737ba8570149d92f4f))
-* **system-open:** use notify for system-open failures and tidy messages ([9d241e5](https://github.com/nvim-tree/nvim-tree.lua/commit/9d241e5f5889cf8d37c3a8054b3e55157549c283))
-* trash.cmd defaults to 'trash' on macos and windows, document option ([#2336](https://github.com/nvim-tree/nvim-tree.lua/issues/2336)) ([0a54dcb](https://github.com/nvim-tree/nvim-tree.lua/commit/0a54dcb76b02f3a4e2da370c7a3f6f2b7b43ef01))
-* **trash:** do not run trash command when trash is not executable ([cbbc799](https://github.com/nvim-tree/nvim-tree.lua/commit/cbbc799e6c5784fba9b6a842000caaebf07fa122))
-* type annotations for utils.is_nvim_tree_buf ([#2180](https://github.com/nvim-tree/nvim-tree.lua/issues/2180)) ([270c955](https://github.com/nvim-tree/nvim-tree.lua/commit/270c95556cad96d18ca547d86ae65927334b108b))
-* typo on clipboard notify ([#2032](https://github.com/nvim-tree/nvim-tree.lua/issues/2032)) ([6117582](https://github.com/nvim-tree/nvim-tree.lua/commit/6117582578d2e5b81212f04db4ad206836bcd24a))
-* use pcall to prevent live-filter regex errors ([#1689](https://github.com/nvim-tree/nvim-tree.lua/issues/1689)) ([3845039](https://github.com/nvim-tree/nvim-tree.lua/commit/3845039c1a47ad0759a1ec7deb6f2ffb4421d175))
-* **view:** do not close window when NvimTree buffer is replaced ([#1391](https://github.com/nvim-tree/nvim-tree.lua/issues/1391)) ([40e515d](https://github.com/nvim-tree/nvim-tree.lua/commit/40e515df87e164454b4df12b7c97a805dd8d2bb8))
-* **view:** file filter and info popup above floating view ([d753a1d](https://github.com/nvim-tree/nvim-tree.lua/commit/d753a1da9a58339f1751db96d37e9b318be91825))
-* **view:** prevent buffer override when actions.open_file.quit_on_open ([e82a921](https://github.com/nvim-tree/nvim-tree.lua/commit/e82a921baab36e9220b31c315b3dc816d6b892c9))
-* **view:** refresh opened files highlight on buffer read, unload  ([#1827](https://github.com/nvim-tree/nvim-tree.lua/issues/1827)) ([18272f8](https://github.com/nvim-tree/nvim-tree.lua/commit/18272f8df3aac2f59dfa31b268c62e0611fbc6c3))
-* **watcher:** failure on watcher teardown message ([#1726](https://github.com/nvim-tree/nvim-tree.lua/issues/1726)) ([6d6a446](https://github.com/nvim-tree/nvim-tree.lua/commit/6d6a44626d4dec58bb61bd40d5bd63d69818c540))
-* **watcher:** only purge on subsequent setup calls, add git_purge log ([899ed45](https://github.com/nvim-tree/nvim-tree.lua/commit/899ed45602090ec9f61a2ed69d218d246e7e035a))
-* **watchers:** disable watchers on kernel filesystems ([ac90664](https://github.com/nvim-tree/nvim-tree.lua/commit/ac906640011df013ca3dd19b6dc71a4fec67cf85)), closes [#1465](https://github.com/nvim-tree/nvim-tree.lua/issues/1465)
-* window picker can't be correctly rendered when cmdheight = 0 ([#1349](https://github.com/nvim-tree/nvim-tree.lua/issues/1349)) ([79258f1](https://github.com/nvim-tree/nvim-tree.lua/commit/79258f1d670277016523e13c0a88daa25070879f))
-* **wipe:** wipe all nvim-tree rogue buffers ([ec530e7](https://github.com/nvim-tree/nvim-tree.lua/commit/ec530e73beec547e04efb11a4f17c912d750c626)), closes [#1438](https://github.com/nvim-tree/nvim-tree.lua/issues/1438)

CONTRIBUTING.md

@@ -4,35 +4,117 @@ Thank you for contributing.
 
 See [Development](https://github.com/nvim-tree/nvim-tree.lua/wiki/Development) for environment setup, tips and tools.
 
-## Styling and formatting
+# Tools
 
-Code is formatted using luacheck, and linted using stylua.
+Following are used during CI and strongly recommended during local development.
-You can install these with:
 
-```bash
+Lint: [luacheck](https://github.com/lunarmodules/luacheck/)
-luarocks install luacheck
+
-cargo install stylua
+Style: [StyLua](https://github.com/JohnnyMorganz/StyLua)
+
+Language server: [luals](https://luals.github.io)
+
+You can install them via you OS package manager e.g. `pacman`, `brew` or other via other package managers such as `cargo` or `luarocks`
+
+# Quality
+
+The following quality checks are mandatory and are performed during CI. They run on the entire `lua` directory and return 1 on any failure.
+
+You can run them all via `make` or `make all`
+
+You can setup git hooks to run all checks by running `scripts/setup-hooks.sh`
+
+## lint
+
+1. Runs luacheck quietly using `.luacheck` settings
+
+```sh
+make lint
 ```
 
-You can setup the git hooks by running `scripts/setup-hooks.sh`.
+## style
 
-## Adding new actions
+1. Runs stylua using `.stylua.toml` settings
+1. Runs `scripts/doc-comments.sh` to validate annotated documentation
+
+```sh
+make style
+```
+
+You can automatically fix stylua issues via:
+
+```sh
+make style-fix
+```
+
+## check
+
+1. Runs the checks that the LSP lua language server runs inside nvim using `.luarc.json` via `scripts/luals-check.sh`
+
+```sh
+make check
+```
+
+Assumes `$VIMRUNTIME` is `/usr/share/nvim/runtime`. Adjust as necessary e.g.
+
+```sh
+VIMRUNTIME="/my/path/to/runtime" make check
+```
+
+If `lua-language-server` is not available or `--check` doesn't function (e.g. Arch Linux 3.9.1-1) you can manually install it as per `ci.yml` e.g.
+
+```sh
+mkdir luals
+curl -L "https://github.com/LuaLS/lua-language-server/releases/download/3.9.1/lua-language-server-3.9.1-linux-x64.tar.gz" | tar zx --directory luals
+
+PATH="luals/bin:${PATH}" make check
+```
+
+# Adding New Actions
 
 To add a new action, add a file in `actions/name-of-the-action.lua`. You should export a `setup` function if some configuration is needed.
-Once you did, you should run the `scripts/update-help.sh`.
 
-## Documentation
+Once you did, you should run `make help-update`
+
+# Documentation
+
+## Opts
 
 When adding new options, you should declare the defaults in the main `nvim-tree.lua` file.
-Once you did, you should run the `scripts/update-help.sh`.
 
 Documentation for options should also be added to `nvim-tree-opts` in `doc/nvim-tree-lua.txt`
 
-## Pull Request
+## API
 
-Please reference any issues in the description e.g. "resolves #1234".
+When adding or changing API please update :help nvim-tree-api
+
+# Pull Request
+
+Please reference any issues in the description e.g. "resolves #1234", which will be closed upon merge.
 
 Please check "allow edits by maintainers" to allow nvim-tree developers to make small changes such as documentation tweaks.
 
-A test case to reproduce the issue is required. A ["Clean Room" Replication](https://github.com/nvim-tree/nvim-tree.lua/wiki/Troubleshooting#clean-room-replication) is preferred.
+## Subject
 
+The merge commit message will be the subject of the PR.
+
+A [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0) subject will be validated by the Semantic Pull Request Subject CI job. Reference the issue to be used in the release notes e.g.
+
+`fix(#2395): marks.bulk.move defaults to directory at cursor`
+
+Available types:
+* feat: A new feature
+* fix: A bug fix
+* docs: Documentation only changes
+* style: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)
+* refactor: A code change that neither fixes a bug nor adds a feature
+* perf: A code change that improves performance
+* test: Adding missing tests or correcting existing tests
+* build: Changes that affect the build system or external dependencies (example scopes: gulp, broccoli, npm)
+* ci: Changes to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs)
+* chore: Other changes that don't modify src or test files
+* revert: Reverts a previous commit
+
+If in doubt, look at previous commits.
+
+See also [The Conventional Commits ultimate cheatsheet](https://gist.github.com/gabrielecanepa/fa6cca1a8ae96f77896fe70ddee65527)

Makefile

@@ -0,0 +1,47 @@
+all: lint style check
+
+#
+# mandatory checks
+#
+lint: luacheck
+
+style: stylua style-doc
+
+check: luals
+
+#
+# subtasks
+#
+luacheck:
+	luacheck -q lua
+
+stylua:
+	stylua lua --check
+
+style-doc:
+	scripts/doc-comments.sh
+
+luals:
+	@scripts/luals-check.sh
+
+#
+# fixes
+#
+style-fix:
+	stylua lua
+
+#
+# utility
+#
+help-update:
+	scripts/help-update.sh
+
+#
+# CI
+#
+help-check: help-update
+	git diff --exit-code doc/nvim-tree-lua.txt
+
+
+.PHONY: all lint style check luacheck stylua style-doc luals style-fix help-update help-check
+

README.md

@@ -24,11 +24,11 @@
 
 Take a look at the [wiki](https://github.com/nvim-tree/nvim-tree.lua/wiki) for Showcases, Tips, Recipes and more.
 
-Community support: [matrix](https://matrix.to/#/#nvim-tree:matrix.org)
+Questions and general support: [Discussions](https://github.com/nvim-tree/nvim-tree.lua/discussions)
 
 ## Requirements
 
-[neovim >=0.8.0](https://github.com/neovim/neovim/wiki/Installing-Neovim)
+[neovim >=0.9.0](https://github.com/neovim/neovim/wiki/Installing-Neovim)
 
 [nvim-web-devicons](https://github.com/nvim-tree/nvim-web-devicons) is optional and used to display file icons. It requires a [patched font](https://www.nerdfonts.com/). Your terminal emulator must be configured to use that font, usually "Hack Nerd Font"
 
@@ -38,6 +38,8 @@ Please install via your preferred package manager. See [Installation](https://gi
 
 `nvim-tree/nvim-tree.lua`
 
+Major or minor versions may be specified via tags: `v<MAJOR>` e.g. `v1` or `v<MAJOR>.<MINOR>` e.g. `v1.23`
+
 `nvim-tree/nvim-web-devicons` optional, for file icons
 
 Disabling [netrw](https://neovim.io/doc/user/pi_netrw.html) is strongly advised, see [:help nvim-tree-netrw](doc/nvim-tree-lua.txt)
@@ -53,7 +55,7 @@ Setup the plugin in your `init.lua`
 vim.g.loaded_netrw = 1
 vim.g.loaded_netrwPlugin = 1
 
--- set termguicolors to enable highlight groups
+-- optionally enable 24-bit colour
 vim.opt.termguicolors = true
 
 -- empty setup using defaults
@@ -110,6 +112,23 @@ require("nvim-tree").setup {
 }
 ```
 
+### Highlight
+
+Run `:NvimTreeHiTest` to show all the highlights that nvim-tree uses.
+
+They can be customised before or after setup is called and will be immediately
+applied at runtime. e.g.
+
+```lua
+vim.cmd([[
+    :hi      NvimTreeExecFile    guifg=#ffa0a0
+    :hi      NvimTreeSpecialFile guifg=#ff80ff gui=underline
+    :hi      NvimTreeSymlink     guifg=Yellow  gui=italic
+    :hi link NvimTreeImageFile   Title
+]])
+```
+See [:help nvim-tree-highlight](doc/nvim-tree-lua.txt) for details.
+
 ## Commands
 
 See [:help nvim-tree-commands](doc/nvim-tree-lua.txt)

lua/nvim-tree.lua

@@ -1,19 +1,10 @@
 local lib = require "nvim-tree.lib"
 local log = require "nvim-tree.log"
-local colors = require "nvim-tree.colors"
+local appearance = require "nvim-tree.appearance"
-local renderer = require "nvim-tree.renderer"
 local view = require "nvim-tree.view"
-local commands = require "nvim-tree.commands"
 local utils = require "nvim-tree.utils"
-local change_dir = require "nvim-tree.actions.root.change-dir"
+local actions = require "nvim-tree.actions"
-local legacy = require "nvim-tree.legacy"
 local core = require "nvim-tree.core"
-local reloaders = require "nvim-tree.actions.reloaders.reloaders"
-local git = require "nvim-tree.git"
-local filters = require "nvim-tree.explorer.filters"
-local modified = require "nvim-tree.modified"
-local find_file = require "nvim-tree.actions.tree.find-file"
-local events = require "nvim-tree.events"
 local notify = require "nvim-tree.notify"
 
 local _config = {}
@@ -28,8 +19,15 @@ local M = {
 function M.change_root(path, bufnr)
   -- skip if current file is in ignore_list
   if type(bufnr) == "number" then
-    local ft = vim.api.nvim_buf_get_option(bufnr, "filetype") or ""
+    local ft
-    for _, value in pairs(_config.update_focused_file.ignore_list) do
+
+    if vim.fn.has "nvim-0.10" == 1 then
+      ft = vim.api.nvim_get_option_value("filetype", { buf = bufnr }) or ""
+    else
+      ft = vim.api.nvim_buf_get_option(bufnr, "filetype") or "" ---@diagnostic disable-line: deprecated
+    end
+
+    for _, value in pairs(_config.update_focused_file.update_root.ignore_list) do
       if utils.str_find(path, value) or utils.str_find(ft, value) then
         return
       end
@@ -51,7 +49,7 @@ function M.change_root(path, bufnr)
   -- test if in vim_cwd
   if utils.path_relative(path, vim_cwd) ~= path then
     if vim_cwd ~= cwd then
-      change_dir.fn(vim_cwd)
+      actions.root.change_dir.fn(vim_cwd)
     end
     return
   end
@@ -62,56 +60,43 @@ function M.change_root(path, bufnr)
 
   -- otherwise test M.init_root
   if _config.prefer_startup_root and utils.path_relative(path, M.init_root) ~= path then
-    change_dir.fn(M.init_root)
+    actions.root.change_dir.fn(M.init_root)
     return
   end
   -- otherwise root_dirs
   for _, dir in pairs(_config.root_dirs) do
     dir = vim.fn.fnamemodify(dir, ":p")
     if utils.path_relative(path, dir) ~= path then
-      change_dir.fn(dir)
+      actions.root.change_dir.fn(dir)
       return
     end
   end
   -- finally fall back to the folder containing the file
-  change_dir.fn(vim.fn.fnamemodify(path, ":p:h"))
+  actions.root.change_dir.fn(vim.fn.fnamemodify(path, ":p:h"))
-end
-
----@param cwd string|nil
-function M.open_replacing_current_buffer(cwd)
-  if view.is_visible() then
-    return
-  end
-
-  local buf = vim.api.nvim_get_current_buf()
-  local bufname = vim.api.nvim_buf_get_name(buf)
-  if bufname == "" or vim.loop.fs_stat(bufname) == nil then
-    return
-  end
-
-  if cwd == "" or cwd == nil then
-    cwd = vim.fn.fnamemodify(bufname, ":p:h")
-  end
-
-  if not core.get_explorer() or cwd ~= core.get_cwd() then
-    core.init(cwd)
-  end
-  view.open_in_win { hijack_current_buf = false, resize = false }
-  require("nvim-tree.renderer").draw()
-  require("nvim-tree.actions.finders.find-file").fn(bufname)
 end
 
 function M.tab_enter()
   if view.is_visible { any_tabpage = true } then
     local bufname = vim.api.nvim_buf_get_name(0)
-    local ft = vim.api.nvim_buf_get_option(0, "ft")
+
+    local ft
+    if vim.fn.has "nvim-0.10" == 1 then
+      ft = vim.api.nvim_get_option_value("filetype", { buf = 0 }) or ""
+    else
+      ft = vim.api.nvim_buf_get_option(0, "ft") ---@diagnostic disable-line: deprecated
+    end
+
     for _, filter in ipairs(M.config.tab.sync.ignore) do
       if bufname:match(filter) ~= nil or ft:match(filter) ~= nil then
         return
       end
     end
     view.open { focus_tree = false }
-    require("nvim-tree.renderer").draw()
+
+    local explorer = core.get_explorer()
+    if explorer then
+      explorer.renderer:draw()
+    end
   end
 end
 
@@ -127,27 +112,20 @@ function M.open_on_directory()
     return
   end
 
-  change_dir.force_dirchange(bufname, true)
+  actions.root.change_dir.force_dirchange(bufname, true)
 end
 
-function M.reset_highlight()
-  colors.setup()
-  view.reset_winhl()
-  renderer.render_hl(view.get_bufnr())
-end
-
-local prev_line
 function M.place_cursor_on_node()
-  local l = vim.api.nvim_win_get_cursor(0)[1]
+  local ok, search = pcall(vim.fn.searchcount)
-  if l == prev_line then
+  if ok and search and search.exact_match == 1 then
     return
   end
-  prev_line = l
 
   local node = lib.get_node_at_cursor()
   if not node or node.name == ".." then
     return
   end
+  node = utils.get_parent_of_group(node)
 
   local line = vim.api.nvim_get_current_line()
   local cursor = vim.api.nvim_win_get_cursor(0)
@@ -179,11 +157,11 @@ end
 ---@param name string|nil
 function M.change_dir(name)
   if name then
-    change_dir.fn(name)
+    actions.root.change_dir.fn(name)
   end
 
-  if _config.update_focused_file.enable then
+  if _config.update_focused_file.update_root.enable then
-    find_file.fn()
+    actions.tree.find_file.fn()
   end
 end
 
@@ -195,8 +173,18 @@ local function setup_autocommands(opts)
     vim.api.nvim_create_autocmd(name, vim.tbl_extend("force", default_opts, custom_opts))
   end
 
-  -- reset highlights when colorscheme is changed
+  -- reset and draw (highlights) when colorscheme is changed
-  create_nvim_tree_autocmd("ColorScheme", { callback = M.reset_highlight })
+  create_nvim_tree_autocmd("ColorScheme", {
+    callback = function()
+      appearance.setup()
+      view.reset_winhl()
+
+      local explorer = core.get_explorer()
+      if explorer then
+        explorer.renderer:draw()
+      end
+    end,
+  })
 
   -- prevent new opened file from opening in the same window as nvim-tree
   create_nvim_tree_autocmd("BufWipeout", {
@@ -216,7 +204,10 @@ local function setup_autocommands(opts)
   create_nvim_tree_autocmd("BufWritePost", {
     callback = function()
       if opts.auto_reload_on_write and not opts.filesystem_watchers.enable then
-        reloaders.reload_explorer()
+        local explorer = core.get_explorer()
+        if explorer then
+          explorer:reload_explorer()
+        end
       end
     end,
   })
@@ -224,9 +215,15 @@ local function setup_autocommands(opts)
   create_nvim_tree_autocmd("BufReadPost", {
     callback = function(data)
       -- update opened file buffers
-      if (filters.config.filter_no_buffer or renderer.config.highlight_opened_files ~= "none") and vim.bo[data.buf].buftype == "" then
+      local explorer = core.get_explorer()
+      if not explorer then
+        return
+      end
+      if
+        (explorer.filters.config.filter_no_buffer or explorer.opts.highlight_opened_files ~= "none") and vim.bo[data.buf].buftype == ""
+      then
         utils.debounce("Buf:filter_buffer", opts.view.debounce_delay, function()
-          reloaders.reload_explorer()
+          explorer:reload_explorer()
         end)
       end
     end,
@@ -235,9 +232,15 @@ local function setup_autocommands(opts)
   create_nvim_tree_autocmd("BufUnload", {
     callback = function(data)
       -- update opened file buffers
-      if (filters.config.filter_no_buffer or renderer.config.highlight_opened_files ~= "none") and vim.bo[data.buf].buftype == "" then
+      local explorer = core.get_explorer()
+      if not explorer then
+        return
+      end
+      if
+        (explorer.filters.config.filter_no_buffer or explorer.opts.highlight_opened_files ~= "none") and vim.bo[data.buf].buftype == ""
+      then
         utils.debounce("Buf:filter_buffer", opts.view.debounce_delay, function()
-          reloaders.reload_explorer(nil, data.buf)
+          explorer:reload_explorer()
         end)
       end
     end,
@@ -247,7 +250,10 @@ local function setup_autocommands(opts)
     pattern = { "FugitiveChanged", "NeogitStatusRefreshed" },
     callback = function()
       if not opts.filesystem_watchers.enable and opts.git.enable then
-        reloaders.reload_git()
+        local explorer = core.get_explorer()
+        if explorer then
+          explorer:reload_git()
+        end
       end
     end,
   })
@@ -274,9 +280,13 @@ local function setup_autocommands(opts)
   end
   if opts.update_focused_file.enable then
     create_nvim_tree_autocmd("BufEnter", {
-      callback = function()
+      callback = function(event)
+        local exclude = opts.update_focused_file.exclude
+        if type(exclude) == "function" and exclude(event) then
+          return
+        end
         utils.debounce("BufEnter:find_file", opts.view.debounce_delay, function()
-          find_file.fn()
+          actions.tree.find_file.fn()
         end)
       end,
     })
@@ -291,7 +301,10 @@ local function setup_autocommands(opts)
     callback = function()
       if utils.is_nvim_tree_buf(0) then
         if vim.fn.getcwd() ~= core.get_cwd() or (opts.reload_on_bufenter and not opts.filesystem_watchers.enable) then
-          reloaders.reload_explorer()
+          local explorer = core.get_explorer()
+          if explorer then
+            explorer:reload_explorer()
+          end
         end
       end
     end,
@@ -341,24 +354,12 @@ local function setup_autocommands(opts)
     create_nvim_tree_autocmd({ "BufModifiedSet", "BufWritePost" }, {
       callback = function()
         utils.debounce("Buf:modified", opts.view.debounce_delay, function()
-          modified.reload()
+          require("nvim-tree.buffers").reload_modified()
-          reloaders.reload_explorer()
+          local explorer = core.get_explorer()
-        end)
+          if explorer then
-      end,
+            explorer:reload_explorer()
-    })
-  end
-
-  -- TODO #1545 remove similar check from view.resize
-  if vim.fn.has "nvim-0.9" == 1 then
-    create_nvim_tree_autocmd("WinResized", {
-      callback = function()
-        if vim.v.event and vim.v.event.windows then
-          for _, winid in ipairs(vim.v.event.windows) do
-            if vim.api.nvim_win_is_valid(winid) and utils.is_nvim_tree_buf(vim.api.nvim_win_get_buf(winid)) then
-              events._dispatch_on_tree_resize(vim.api.nvim_win_get_width(winid))
-            end
           end
-        end
+        end)
       end,
     })
   end
@@ -412,11 +413,13 @@ local DEFAULT_OPTS = { -- BEGIN_DEFAULT_OPTS
     root_folder_label = ":~:s?$?/..?",
     indent_width = 2,
     special_files = { "Cargo.toml", "Makefile", "README.md", "readme.md" },
+    hidden_display = "none",
     symlink_destination = true,
-    highlight_git = false,
+    highlight_git = "none",
-    highlight_diagnostics = false,
+    highlight_diagnostics = "none",
     highlight_opened_files = "none",
     highlight_modified = "none",
+    highlight_hidden = "none",
     highlight_bookmarks = "none",
     highlight_clipboard = "name",
     indent_markers = {
@@ -443,6 +446,7 @@ local DEFAULT_OPTS = { -- BEGIN_DEFAULT_OPTS
       },
       git_placement = "before",
       modified_placement = "after",
+      hidden_placement = "after",
       diagnostics_placement = "signcolumn",
       bookmarks_placement = "signcolumn",
       padding = " ",
@@ -453,6 +457,7 @@ local DEFAULT_OPTS = { -- BEGIN_DEFAULT_OPTS
         folder_arrow = true,
         git = true,
         modified = true,
+        hidden = false,
         diagnostics = true,
         bookmarks = true,
       },
@@ -461,6 +466,7 @@ local DEFAULT_OPTS = { -- BEGIN_DEFAULT_OPTS
         symlink = "",
         bookmark = "󰆤",
         modified = "●",
+        hidden = "󰜌",
         folder = {
           arrow_closed = "",
           arrow_open = "",
@@ -489,8 +495,11 @@ local DEFAULT_OPTS = { -- BEGIN_DEFAULT_OPTS
   },
   update_focused_file = {
     enable = false,
-    update_root = false,
+    update_root = {
-    ignore_list = {},
+      enable = false,
+      ignore_list = {},
+    },
+    exclude = false,
   },
   system_open = {
     cmd = "",
@@ -526,10 +535,12 @@ local DEFAULT_OPTS = { -- BEGIN_DEFAULT_OPTS
     show_on_open_dirs = true,
   },
   filters = {
+    enable = true,
     git_ignored = true,
     dotfiles = false,
     git_clean = false,
     no_buffer = false,
+    no_bookmark = false,
     custom = {},
     exclude = {},
   },
@@ -604,7 +615,13 @@ local DEFAULT_OPTS = { -- BEGIN_DEFAULT_OPTS
       default_yes = false,
     },
   },
-  experimental = {},
+  experimental = {
+    actions = {
+      open_file = {
+        relative_path = false,
+      },
+    },
+  },
   log = {
     enable = false,
     truncate = false,
@@ -646,9 +663,22 @@ local ACCEPTED_TYPES = {
     },
   },
   renderer = {
+    hidden_display = { "function", "string" },
     group_empty = { "boolean", "function" },
     root_folder_label = { "function", "string", "boolean" },
   },
+  update_focused_file = {
+    exclude = { "function" },
+  },
+  git = {
+    disable_for_dirs = { "function" },
+  },
+  filters = {
+    custom = { "function" },
+  },
+  filesystem_watchers = {
+    ignore_dirs = { "function" },
+  },
   actions = {
     open_file = {
       window_picker = {
@@ -667,15 +697,20 @@ local ACCEPTED_STRINGS = {
     signcolumn = { "yes", "no", "auto" },
   },
   renderer = {
+    hidden_display = { "none", "simple", "all" },
+    highlight_git = { "none", "icon", "name", "all" },
     highlight_opened_files = { "none", "icon", "name", "all" },
     highlight_modified = { "none", "icon", "name", "all" },
+    highlight_hidden = { "none", "icon", "name", "all" },
     highlight_bookmarks = { "none", "icon", "name", "all" },
+    highlight_diagnostics = { "none", "icon", "name", "all" },
     highlight_clipboard = { "none", "icon", "name", "all" },
     icons = {
-      git_placement = { "before", "after", "signcolumn" },
+      git_placement = { "before", "after", "signcolumn", "right_align" },
-      modified_placement = { "before", "after", "signcolumn" },
+      modified_placement = { "before", "after", "signcolumn", "right_align" },
-      diagnostics_placement = { "before", "after", "signcolumn" },
+      hidden_placement = { "before", "after", "signcolumn", "right_align" },
-      bookmarks_placement = { "before", "after", "signcolumn" },
+      diagnostics_placement = { "before", "after", "signcolumn", "right_align" },
+      bookmarks_placement = { "before", "after", "signcolumn", "right_align" },
     },
   },
   help = {
@@ -769,15 +804,15 @@ function M.purge_all_state()
   view.close_all_tabs()
   view.abandon_all_windows()
   if core.get_explorer() ~= nil then
-    git.purge_state()
+    require("nvim-tree.git").purge_state()
     core.reset_explorer()
   end
 end
 
 ---@param conf table|nil
 function M.setup(conf)
-  if vim.fn.has "nvim-0.8" == 0 then
+  if vim.fn.has "nvim-0.9" == 0 then
-    notify.warn "nvim-tree.lua requires Neovim 0.8 or higher"
+    notify.warn "nvim-tree.lua requires Neovim 0.9 or higher"
     return
   end
 
@@ -785,7 +820,7 @@ function M.setup(conf)
 
   localise_default_opts()
 
-  legacy.migrate_legacy_options(conf or {})
+  require("nvim-tree.legacy").migrate_legacy_options(conf or {})
 
   validate_options(conf)
 
@@ -812,17 +847,15 @@ function M.setup(conf)
 
   require("nvim-tree.actions").setup(opts)
   require("nvim-tree.keymap").setup(opts)
-  require("nvim-tree.colors").setup()
+  require("nvim-tree.appearance").setup()
   require("nvim-tree.diagnostics").setup(opts)
   require("nvim-tree.explorer").setup(opts)
   require("nvim-tree.git").setup(opts)
   require("nvim-tree.git.utils").setup(opts)
   require("nvim-tree.view").setup(opts)
   require("nvim-tree.lib").setup(opts)
-  require("nvim-tree.renderer").setup(opts)
+  require("nvim-tree.renderer.components").setup(opts)
-  require("nvim-tree.live-filter").setup(opts)
+  require("nvim-tree.buffers").setup(opts)
-  require("nvim-tree.marks").setup(opts)
-  require("nvim-tree.modified").setup(opts)
   require("nvim-tree.help").setup(opts)
   require("nvim-tree.watcher").setup(opts)
   if M.config.renderer.icons.show.file and pcall(require, "nvim-web-devicons") then
@@ -833,7 +866,7 @@ function M.setup(conf)
 
   if vim.g.NvimTreeSetup ~= 1 then
     -- first call to setup
-    commands.setup()
+    require("nvim-tree.commands").setup()
   else
     -- subsequent calls to setup
     M.purge_all_state()

lua/nvim-tree/actions/finders/find-file.lua

@@ -1,8 +1,6 @@
 local log = require "nvim-tree.log"
 local view = require "nvim-tree.view"
 local utils = require "nvim-tree.utils"
-local renderer = require "nvim-tree.renderer"
-local reload = require "nvim-tree.explorer.reload"
 local core = require "nvim-tree.core"
 local Iterator = require "nvim-tree.iterators.node-iterator"
 
@@ -13,7 +11,8 @@ local running = {}
 ---Find a path in the tree, expand it and focus it
 ---@param path string relative or absolute
 function M.fn(path)
-  if not core.get_explorer() or not view.is_visible() then
+  local explorer = core.get_explorer()
+  if not explorer or not view.is_visible() then
     return
   end
 
@@ -32,7 +31,7 @@ function M.fn(path)
 
   -- refresh the contents of all parents, expanding groups as needed
   if utils.get_node_from_path(path_real) == nil then
-    reload.refresh_parent_nodes_for_path(vim.fn.fnamemodify(path_real, ":h"))
+    explorer:refresh_parent_nodes_for_path(vim.fn.fnamemodify(path_real, ":h"))
   end
 
   local line = core.get_nodes_starting_line()
@@ -76,7 +75,7 @@ function M.fn(path)
     :iterate()
 
   if found and view.is_visible() then
-    renderer.draw()
+    explorer.renderer:draw()
     view.set_cursor { line, 0 }
   end
 

lua/nvim-tree/actions/finders/init.lua

@@ -0,0 +1,6 @@
+local M = {}
+
+M.find_file = require "nvim-tree.actions.finders.find-file"
+M.search_node = require "nvim-tree.actions.finders.search-node"
+
+return M

lua/nvim-tree/actions/finders/search-node.lua

@@ -1,5 +1,4 @@
 local core = require "nvim-tree.core"
-local filters = require "nvim-tree.explorer.filters"
 local find_file = require("nvim-tree.actions.finders.find-file").fn
 
 local M = {}
@@ -9,6 +8,11 @@ local M = {}
 ---@return string|nil
 local function search(search_dir, input_path)
   local realpaths_searched = {}
+  local explorer = core.get_explorer()
+
+  if not explorer then
+    return
+  end
 
   if not search_dir then
     return
@@ -19,7 +23,7 @@ local function search(search_dir, input_path)
   local function iter(dir)
     local realpath, path, name, stat, handle, _
 
-    local filter_status = filters.prepare()
+    local filter_status = explorer.filters:prepare()
 
     handle, _ = vim.loop.fs_scandir(dir)
     if not handle then
@@ -36,12 +40,13 @@ local function search(search_dir, input_path)
     while name do
       path = dir .. "/" .. name
 
+      ---@type uv.fs_stat.result|nil
       stat, _ = vim.loop.fs_stat(path)
       if not stat then
         break
       end
 
-      if not filters.should_filter(path, filter_status) then
+      if not explorer.filters:should_filter(path, stat, filter_status) then
         if string.find(path, "/" .. input_path .. "$") then
           return path
         end
@@ -68,8 +73,15 @@ function M.fn()
 
   -- temporarily set &path
   local bufnr = vim.api.nvim_get_current_buf()
-  local path_existed, path_opt = pcall(vim.api.nvim_buf_get_option, bufnr, "path")
+
-  vim.api.nvim_buf_set_option(bufnr, "path", core.get_cwd() .. "/**")
+  local path_existed, path_opt
+  if vim.fn.has "nvim-0.10" == 1 then
+    path_existed, path_opt = pcall(vim.api.nvim_get_option_value, "path", { buf = bufnr })
+    vim.api.nvim_set_option_value("path", core.get_cwd() .. "/**", { buf = bufnr })
+  else
+    path_existed, path_opt = pcall(vim.api.nvim_buf_get_option, bufnr, "path") ---@diagnostic disable-line: deprecated
+    vim.api.nvim_buf_set_option(bufnr, "path", core.get_cwd() .. "/**") ---@diagnostic disable-line: deprecated
+  end
 
   vim.ui.input({ prompt = "Search: ", completion = "file_in_path" }, function(input_path)
     if not input_path or input_path == "" then
@@ -77,9 +89,17 @@ function M.fn()
     end
     -- reset &path
     if path_existed then
-      vim.api.nvim_buf_set_option(bufnr, "path", path_opt)
+      if vim.fn.has "nvim-0.10" == 1 then
+        vim.api.nvim_set_option_value("path", path_opt, { buf = bufnr })
+      else
+        vim.api.nvim_buf_set_option(bufnr, "path", path_opt) ---@diagnostic disable-line: deprecated
+      end
     else
-      vim.api.nvim_buf_set_option(bufnr, "path", nil)
+      if vim.fn.has "nvim-0.10" == 1 then
+        vim.api.nvim_set_option_value("path", nil, { buf = bufnr })
+      else
+        vim.api.nvim_buf_set_option(bufnr, "path", nil) ---@diagnostic disable-line: deprecated
+      end
     end
 
     -- strip trailing slash

lua/nvim-tree/actions/fs/clipboard.lua

@@ -4,21 +4,41 @@ local utils = require "nvim-tree.utils"
 local core = require "nvim-tree.core"
 local events = require "nvim-tree.events"
 local notify = require "nvim-tree.notify"
-local renderer = require "nvim-tree.renderer"
-local reloaders = require "nvim-tree.actions.reloaders.reloaders"
-
-local HL_POSITION = require("nvim-tree.enum").HL_POSITION
 
 local find_file = require("nvim-tree.actions.finders.find-file").fn
 
-local M = {
+---@enum ACTION
-  config = {},
+local ACTION = {
+  copy = "copy",
+  cut = "cut",
 }
 
-local clipboard = {
+---@class Clipboard to handle all actions.fs clipboard API
-  cut = {},
+---@field config table hydrated user opts.filters
-  copy = {},
+---@field private explorer Explorer
-}
+---@field private data table<ACTION, Node[]>
+local Clipboard = {}
+
+---@param opts table user options
+---@param explorer Explorer
+---@return Clipboard
+function Clipboard:new(opts, explorer)
+  local o = {
+    explorer = explorer,
+    data = {
+      [ACTION.copy] = {},
+      [ACTION.cut] = {},
+    },
+    config = {
+      filesystem_watchers = opts.filesystem_watchers,
+      actions = opts.actions,
+    },
+  }
+
+  setmetatable(o, self)
+  self.__index = self
+  return o
+end
 
 ---@param source string
 ---@param destination string
@@ -87,11 +107,11 @@ end
 
 ---@param source string
 ---@param dest string
----@param action_type string
+---@param action ACTION
 ---@param action_fn fun(source: string, dest: string)
 ---@return boolean|nil -- success
 ---@return string|nil -- error message
-local function do_single_paste(source, dest, action_type, action_fn)
+local function do_single_paste(source, dest, action, action_fn)
   local dest_stats
   local success, errmsg, errcode
   local notify_source = notify.render_path(source)
@@ -100,14 +120,14 @@ local function do_single_paste(source, dest, action_type, action_fn)
 
   dest_stats, errmsg, errcode = vim.loop.fs_stat(dest)
   if not dest_stats and errcode ~= "ENOENT" then
-    notify.error("Could not " .. action_type .. " " .. notify_source .. " - " .. (errmsg or "???"))
+    notify.error("Could not " .. action .. " " .. notify_source .. " - " .. (errmsg or "???"))
     return false, errmsg
   end
 
   local function on_process()
     success, errmsg = action_fn(source, dest)
     if not success then
-      notify.error("Could not " .. action_type .. " " .. notify_source .. " - " .. (errmsg or "???"))
+      notify.error("Could not " .. action .. " " .. notify_source .. " - " .. (errmsg or "???"))
       return false, errmsg
     end
 
@@ -125,13 +145,13 @@ local function do_single_paste(source, dest, action_type, action_fn)
       vim.ui.input(input_opts, function(new_dest)
         utils.clear_prompt()
         if new_dest then
-          do_single_paste(source, new_dest, action_type, action_fn)
+          do_single_paste(source, new_dest, action, action_fn)
         end
       end)
     else
       local prompt_select = "Overwrite " .. dest .. " ?"
       local prompt_input = prompt_select .. " R(ename)/y/n: "
-      lib.prompt(prompt_input, prompt_select, { "", "y", "n" }, { "Rename", "Yes", "No" }, function(item_short)
+      lib.prompt(prompt_input, prompt_select, { "", "y", "n" }, { "Rename", "Yes", "No" }, "nvimtree_overwrite_rename", function(item_short)
         utils.clear_prompt()
         if item_short == "y" then
           on_process()
@@ -139,7 +159,7 @@ local function do_single_paste(source, dest, action_type, action_fn)
           vim.ui.input(input_opts, function(new_dest)
             utils.clear_prompt()
             if new_dest then
-              do_single_paste(source, new_dest, action_type, action_fn)
+              do_single_paste(source, new_dest, action, action_fn)
             end
           end)
         end
@@ -167,37 +187,42 @@ local function toggle(node, clip)
   notify.info(notify_node .. " added to clipboard.")
 end
 
-function M.clear_clipboard()
+---Clear copied and cut
-  clipboard.cut = {}
+function Clipboard:clear_clipboard()
-  clipboard.copy = {}
+  self.data[ACTION.copy] = {}
+  self.data[ACTION.cut] = {}
   notify.info "Clipboard has been emptied."
-  renderer.draw()
+  self.explorer.renderer:draw()
 end
 
+---Copy one node
 ---@param node Node
-function M.copy(node)
+function Clipboard:copy(node)
-  utils.array_remove(clipboard.cut, node)
+  utils.array_remove(self.data[ACTION.cut], node)
-  toggle(node, clipboard.copy)
+  toggle(node, self.data[ACTION.copy])
-  renderer.draw()
+  self.explorer.renderer:draw()
 end
 
+---Cut one node
 ---@param node Node
-function M.cut(node)
+function Clipboard:cut(node)
-  utils.array_remove(clipboard.copy, node)
+  utils.array_remove(self.data[ACTION.copy], node)
-  toggle(node, clipboard.cut)
+  toggle(node, self.data[ACTION.cut])
-  renderer.draw()
+  self.explorer.renderer:draw()
 end
 
+---Paste cut or cop
+---@private
 ---@param node Node
----@param action_type string
+---@param action ACTION
 ---@param action_fn fun(source: string, dest: string)
-local function do_paste(node, action_type, action_fn)
+function Clipboard:do_paste(node, action, action_fn)
   node = lib.get_last_group_node(node)
   local explorer = core.get_explorer()
   if node.name == ".." and explorer then
     node = explorer
   end
-  local clip = clipboard[action_type]
+  local clip = self.data[action]
   if #clip == 0 then
     return
   end
@@ -206,7 +231,7 @@ local function do_paste(node, action_type, action_fn)
   local stats, errmsg, errcode = vim.loop.fs_stat(destination)
   if not stats and errcode ~= "ENOENT" then
     log.line("copy_paste", "do_paste fs_stat '%s' failed '%s'", destination, errmsg)
-    notify.error("Could not " .. action_type .. " " .. notify.render_path(destination) .. " - " .. (errmsg or "???"))
+    notify.error("Could not " .. action .. " " .. notify.render_path(destination) .. " - " .. (errmsg or "???"))
     return
   end
   local is_dir = stats and stats.type == "directory"
@@ -216,12 +241,12 @@ local function do_paste(node, action_type, action_fn)
 
   for _, _node in ipairs(clip) do
     local dest = utils.path_join { destination, _node.name }
-    do_single_paste(_node.absolute_path, dest, action_type, action_fn)
+    do_single_paste(_node.absolute_path, dest, action, action_fn)
   end
 
-  clipboard[action_type] = {}
+  self.data[action] = {}
-  if not M.config.filesystem_watchers.enable then
+  if not self.config.filesystem_watchers.enable then
-    reloaders.reload_explorer()
+    self.explorer:reload_explorer()
   end
 end
 
@@ -248,26 +273,27 @@ local function do_cut(source, destination)
   return true
 end
 
+---Paste cut (if present) or copy (if present)
 ---@param node Node
-function M.paste(node)
+function Clipboard:paste(node)
-  if clipboard.cut[1] ~= nil then
+  if self.data[ACTION.cut][1] ~= nil then
-    do_paste(node, "cut", do_cut)
+    self:do_paste(node, ACTION.cut, do_cut)
-  else
+  elseif self.data[ACTION.copy][1] ~= nil then
-    do_paste(node, "copy", do_copy)
+    self:do_paste(node, ACTION.copy, do_copy)
   end
 end
 
-function M.print_clipboard()
+function Clipboard:print_clipboard()
   local content = {}
-  if #clipboard.cut > 0 then
+  if #self.data[ACTION.cut] > 0 then
     table.insert(content, "Cut")
-    for _, node in pairs(clipboard.cut) do
+    for _, node in pairs(self.data[ACTION.cut]) do
       table.insert(content, " * " .. (notify.render_path(node.absolute_path)))
     end
   end
-  if #clipboard.copy > 0 then
+  if #self.data[ACTION.copy] > 0 then
     table.insert(content, "Copy")
-    for _, node in pairs(clipboard.copy) do
+    for _, node in pairs(self.data[ACTION.copy]) do
       table.insert(content, " * " .. (notify.render_path(node.absolute_path)))
     end
   end
@@ -276,75 +302,104 @@ function M.print_clipboard()
 end
 
 ---@param content string
-local function copy_to_clipboard(content)
+function Clipboard:copy_to_reg(content)
   local clipboard_name
-  if M.config.actions.use_system_clipboard == true then
+  local reg
-    vim.fn.setreg("+", content)
+  if self.config.actions.use_system_clipboard == true then
-    vim.fn.setreg('"', content)
     clipboard_name = "system"
+    reg = "+"
   else
-    vim.fn.setreg('"', content)
-    vim.fn.setreg("1", content)
     clipboard_name = "neovim"
+    reg = "1"
   end
 
-  vim.api.nvim_exec_autocmds("TextYankPost", {})
+  -- manually firing TextYankPost does not set vim.v.event
+  -- workaround: create a scratch buffer with the clipboard contents and send a yank command
+  local temp_buf = vim.api.nvim_create_buf(false, true)
+  vim.api.nvim_buf_set_text(temp_buf, 0, 0, 0, 0, { content })
+  vim.api.nvim_buf_call(temp_buf, function()
+    vim.cmd(string.format('normal! "%sy$', reg))
+  end)
+  vim.api.nvim_buf_delete(temp_buf, {})
+
   notify.info(string.format("Copied %s to %s clipboard!", content, clipboard_name))
 end
 
 ---@param node Node
-function M.copy_filename(node)
+function Clipboard:copy_filename(node)
-  copy_to_clipboard(node.name)
+  local content
-end
 
----@param node Node
+  if node.name == ".." then
-function M.copy_path(node)
+    -- root
-  local absolute_path = node.absolute_path
+    content = vim.fn.fnamemodify(self.explorer.absolute_path, ":t")
-  local cwd = core.get_cwd()
+  else
-  if cwd == nil then
+    -- node
-    return
+    content = node.name
   end
 
-  local relative_path = utils.path_relative(absolute_path, cwd)
+  self:copy_to_reg(content)
-  local content = node.nodes ~= nil and utils.path_add_trailing(relative_path) or relative_path
-  copy_to_clipboard(content)
 end
 
 ---@param node Node
-function M.copy_absolute_path(node)
+function Clipboard:copy_basename(node)
+  local content
+
+  if node.name == ".." then
+    -- root
+    content = vim.fn.fnamemodify(self.explorer.absolute_path, ":t:r")
+  else
+    -- node
+    content = vim.fn.fnamemodify(node.name, ":r")
+  end
+
+  self:copy_to_reg(content)
+end
+
+---@param node Node
+function Clipboard:copy_path(node)
+  local content
+
+  if node.name == ".." then
+    -- root
+    content = utils.path_add_trailing ""
+  else
+    -- node
+    local absolute_path = node.absolute_path
+    local cwd = core.get_cwd()
+    if cwd == nil then
+      return
+    end
+
+    local relative_path = utils.path_relative(absolute_path, cwd)
+    content = node.nodes ~= nil and utils.path_add_trailing(relative_path) or relative_path
+  end
+
+  self:copy_to_reg(content)
+end
+
+---@param node Node
+function Clipboard:copy_absolute_path(node)
+  if node.name == ".." then
+    node = self.explorer
+  end
+
   local absolute_path = node.absolute_path
   local content = node.nodes ~= nil and utils.path_add_trailing(absolute_path) or absolute_path
-  copy_to_clipboard(content)
+  self:copy_to_reg(content)
 end
 
---- Clipboard text highlight group and position when highlight_clipboard.
+---Node is cut. Will not be copied.
 ---@param node Node
----@return HL_POSITION position none when clipboard empty
+---@return boolean
----@return string|nil group only when node present in clipboard
+function Clipboard:is_cut(node)
-function M.get_highlight(node)
+  return vim.tbl_contains(self.data[ACTION.cut], node)
-  if M.hl_pos == HL_POSITION.none then
-    return HL_POSITION.none, nil
-  end
-
-  for _, n in ipairs(clipboard.cut) do
-    if node == n then
-      return M.hl_pos, "NvimTreeCutHL"
-    end
-  end
-
-  for _, n in ipairs(clipboard.copy) do
-    if node == n then
-      return M.hl_pos, "NvimTreeCopiedHL"
-    end
-  end
-
-  return HL_POSITION.none, nil
 end
 
-function M.setup(opts)
+---Node is copied. Will not be cut.
-  M.config.filesystem_watchers = opts.filesystem_watchers
+---@param node Node
-  M.config.actions = opts.actions
+---@return boolean
-  M.hl_pos = HL_POSITION[opts.renderer.highlight_clipboard] or HL_POSITION.none
+function Clipboard:is_copied(node)
+  return vim.tbl_contains(self.data[ACTION.copy], node)
 end
 
-return M
+return Clipboard

lua/nvim-tree/actions/fs/create-file.lua

@@ -12,7 +12,7 @@ local M = {}
 local function create_and_notify(file)
   events._dispatch_will_create_file(file)
   local ok, fd = pcall(vim.loop.fs_open, file, "w", 420)
-  if not ok then
+  if not ok or type(fd) ~= "number" then
     notify.error("Couldn't create file " .. notify.render_path(file))
     return
   end

lua/nvim-tree/actions/fs/init.lua

@@ -0,0 +1,14 @@
+local M = {}
+
+M.create_file = require "nvim-tree.actions.fs.create-file"
+M.remove_file = require "nvim-tree.actions.fs.remove-file"
+M.rename_file = require "nvim-tree.actions.fs.rename-file"
+M.trash = require "nvim-tree.actions.fs.trash"
+
+function M.setup(opts)
+  M.remove_file.setup(opts)
+  M.rename_file.setup(opts)
+  M.trash.setup(opts)
+end
+
+return M

lua/nvim-tree/actions/fs/remove-file.lua

@@ -1,3 +1,4 @@
+local core = require "nvim-tree.core"
 local utils = require "nvim-tree.utils"
 local events = require "nvim-tree.events"
 local view = require "nvim-tree.view"
@@ -49,20 +50,25 @@ end
 ---@param cwd string
 ---@return boolean|nil
 local function remove_dir(cwd)
-  local handle = vim.loop.fs_scandir(cwd)
+  local handle, err = vim.loop.fs_scandir(cwd)
-  if type(handle) == "string" then
+  if not handle then
-    notify.error(handle)
+    notify.error(err)
     return
   end
 
   while true do
-    local name, t = vim.loop.fs_scandir_next(handle)
+    local name, _ = vim.loop.fs_scandir_next(handle)
     if not name then
       break
     end
 
     local new_cwd = utils.path_join { cwd, name }
-    if t == "directory" then
+
+    -- Type must come from fs_stat and not fs_scandir_next to maintain sshfs compatibility
+    local stat = vim.loop.fs_stat(new_cwd)
+    local type = stat and stat.type or nil
+
+    if type == "directory" then
       local success = remove_dir(new_cwd)
       if not success then
         return false
@@ -111,8 +117,9 @@ function M.fn(node)
 
   local function do_remove()
     M.remove(node)
-    if not M.config.filesystem_watchers.enable then
+    local explorer = core.get_explorer()
-      require("nvim-tree.actions.reloaders.reloaders").reload_explorer()
+    if not M.config.filesystem_watchers.enable and explorer then
+      explorer:reload_explorer()
     end
   end
 
@@ -130,7 +137,7 @@ function M.fn(node)
       items_long = { "No", "Yes" }
     end
 
-    lib.prompt(prompt_input, prompt_select, items_short, items_long, function(item_short)
+    lib.prompt(prompt_input, prompt_select, items_short, items_long, "nvimtree_remove", function(item_short)
       utils.clear_prompt()
       if item_short == "y" or item_short == (M.config.ui.confirm.default_yes and "") then
         do_remove()

lua/nvim-tree/actions/fs/rename-file.lua

@@ -1,3 +1,4 @@
+local core = require "nvim-tree.core"
 local lib = require "nvim-tree.lib"
 local utils = require "nvim-tree.utils"
 local events = require "nvim-tree.events"
@@ -9,6 +10,16 @@ local M = {
   config = {},
 }
 
+---@param iter function iterable
+---@return integer
+local function get_num_nodes(iter)
+  local i = 0
+  for _ in iter do
+    i = i + 1
+  end
+  return i
+end
+
 local ALLOWED_MODIFIERS = {
   [":p"] = true,
   [":p:h"] = true,
@@ -20,26 +31,69 @@ local function err_fmt(from, to, reason)
   return string.format("Cannot rename %s -> %s: %s", from, to, reason)
 end
 
+local function rename_file_exists(node, to)
+  if not utils.is_macos then
+    return utils.file_exists(to)
+  end
+
+  if string.lower(node) == string.lower(to) then
+    return false
+  end
+
+  return utils.file_exists(to)
+end
+
 ---@param node Node
 ---@param to string
 function M.rename(node, to)
   local notify_from = notify.render_path(node.absolute_path)
   local notify_to = notify.render_path(to)
 
-  if utils.file_exists(to) then
+  if rename_file_exists(notify_from, notify_to) then
     notify.warn(err_fmt(notify_from, notify_to, "file already exists"))
     return
   end
 
-  events._dispatch_will_rename_node(node.absolute_path, to)
+  -- create a folder for each path element if the folder does not exist
-  local success, err = vim.loop.fs_rename(node.absolute_path, to)
+  local idx = 0
-  if not success then
+  local path_to_create = ""
-    notify.warn(err_fmt(notify_from, notify_to, err))
+
-    return
+  local num_nodes = get_num_nodes(utils.path_split(utils.path_remove_trailing(to)))
+  local is_error = false
+  for path in utils.path_split(to) do
+    idx = idx + 1
+
+    local p = utils.path_remove_trailing(path)
+    if #path_to_create == 0 and vim.fn.has "win32" == 1 then
+      path_to_create = utils.path_join { p, path_to_create }
+    else
+      path_to_create = utils.path_join { path_to_create, p }
+    end
+
+    if idx == num_nodes then
+      events._dispatch_will_rename_node(node.absolute_path, to)
+      local success, err = vim.loop.fs_rename(node.absolute_path, to)
+
+      if not success then
+        notify.warn(err_fmt(notify_from, notify_to, err))
+        return
+      end
+    elseif not rename_file_exists(notify_from, path_to_create) then
+      local success = vim.loop.fs_mkdir(path_to_create, 493)
+      if not success then
+        notify.error("Could not create folder " .. notify.render_path(path_to_create))
+        is_error = true
+        break
+      end
+      is_error = false
+    end
+  end
+
+  if not is_error then
+    notify.info(string.format("%s -> %s", notify_from, notify_to))
+    utils.rename_loaded_buffers(node.absolute_path, to)
+    events._dispatch_node_renamed(node.absolute_path, to)
   end
-  notify.info(string.format("%s -> %s", notify_from, notify_to))
-  utils.rename_loaded_buffers(node.absolute_path, to)
-  events._dispatch_node_renamed(node.absolute_path, to)
 end
 
 ---@param default_modifier string|nil
@@ -102,7 +156,10 @@ function M.fn(default_modifier)
 
       M.rename(node, prepend .. new_file_path .. append)
       if not M.config.filesystem_watchers.enable then
-        require("nvim-tree.actions.reloaders.reloaders").reload_explorer()
+        local explorer = core.get_explorer()
+        if explorer then
+          explorer:reload_explorer()
+        end
       end
 
       find_file(utils.path_remove_trailing(new_file_path))

lua/nvim-tree/actions/fs/trash.lua

@@ -1,3 +1,4 @@
+local core = require "nvim-tree.core"
 local lib = require "nvim-tree.lib"
 local notify = require "nvim-tree.notify"
 
@@ -41,7 +42,7 @@ function M.remove(node)
   -- trashes a path (file or folder)
   local function trash_path(on_exit)
     local need_sync_wait = utils.is_windows
-    local job = vim.fn.jobstart(M.config.trash.cmd .. ' "' .. node.absolute_path .. '"', {
+    local job = vim.fn.jobstart(M.config.trash.cmd .. " " .. vim.fn.shellescape(node.absolute_path), {
       detach = not need_sync_wait,
       on_exit = on_exit,
       on_stderr = on_stderr,
@@ -51,6 +52,8 @@ function M.remove(node)
     end
   end
 
+  local explorer = core.get_explorer()
+
   if node.nodes ~= nil and not node.link_to then
     trash_path(function(_, rc)
       if rc ~= 0 then
@@ -58,8 +61,8 @@ function M.remove(node)
         return
       end
       events._dispatch_folder_removed(node.absolute_path)
-      if not M.config.filesystem_watchers.enable then
+      if not M.config.filesystem_watchers.enable and explorer then
-        require("nvim-tree.actions.reloaders.reloaders").reload_explorer()
+        explorer:reload_explorer()
       end
     end)
   else
@@ -71,8 +74,8 @@ function M.remove(node)
       end
       events._dispatch_file_removed(node.absolute_path)
       clear_buffer(node.absolute_path)
-      if not M.config.filesystem_watchers.enable then
+      if not M.config.filesystem_watchers.enable and explorer then
-        require("nvim-tree.actions.reloaders.reloaders").reload_explorer()
+        explorer:reload_explorer()
       end
     end)
   end
@@ -102,7 +105,7 @@ function M.fn(node)
       items_long = { "No", "Yes" }
     end
 
-    lib.prompt(prompt_input, prompt_select, items_short, items_long, function(item_short)
+    lib.prompt(prompt_input, prompt_select, items_short, items_long, "nvimtree_trash", function(item_short)
       utils.clear_prompt()
       if item_short == "y" or item_short == (M.config.ui.confirm.default_yes and "") then
         do_trash()

lua/nvim-tree/actions/init.lua

@@ -1,18 +1,17 @@
 local M = {}
 
+M.finders = require "nvim-tree.actions.finders"
+M.fs = require "nvim-tree.actions.fs"
+M.moves = require "nvim-tree.actions.moves"
+M.node = require "nvim-tree.actions.node"
+M.root = require "nvim-tree.actions.root"
+M.tree = require "nvim-tree.actions.tree"
+
 function M.setup(opts)
-  require("nvim-tree.actions.fs.trash").setup(opts)
+  M.fs.setup(opts)
-  require("nvim-tree.actions.node.system-open").setup(opts)
+  M.node.setup(opts)
-  require("nvim-tree.actions.node.file-popup").setup(opts)
+  M.root.setup(opts)
-  require("nvim-tree.actions.node.open-file").setup(opts)
+  M.tree.setup(opts)
-  require("nvim-tree.actions.root.change-dir").setup(opts)
-  require("nvim-tree.actions.fs.rename-file").setup(opts)
-  require("nvim-tree.actions.fs.remove-file").setup(opts)
-  require("nvim-tree.actions.fs.copy-paste").setup(opts)
-  require("nvim-tree.actions.tree-modifiers.expand-all").setup(opts)
-  require("nvim-tree.actions.tree.find-file").setup(opts)
-  require("nvim-tree.actions.tree.open").setup(opts)
-  require("nvim-tree.actions.tree.toggle").setup(opts)
 end
 
 return M

lua/nvim-tree/actions/moves/init.lua

@@ -0,0 +1,7 @@
+local M = {}
+
+M.item = require "nvim-tree.actions.moves.item"
+M.parent = require "nvim-tree.actions.moves.parent"
+M.sibling = require "nvim-tree.actions.moves.sibling"
+
+return M

lua/nvim-tree/actions/moves/item.lua

@@ -3,53 +3,238 @@ local view = require "nvim-tree.view"
 local core = require "nvim-tree.core"
 local lib = require "nvim-tree.lib"
 local explorer_node = require "nvim-tree.explorer.node"
+local diagnostics = require "nvim-tree.diagnostics"
 
 local M = {}
+local MAX_DEPTH = 100
 
----@param where string
+---Return the status of the node or nil if no status, depending on the type of
----@param what string
+---status.
+---@param node table node to inspect
+---@param what string type of status
+---@param skip_gitignored boolean default false
+---@return boolean
+local function status_is_valid(node, what, skip_gitignored)
+  if what == "git" then
+    local git_status = explorer_node.get_git_status(node)
+    return git_status ~= nil and (not skip_gitignored or git_status[1] ~= "!!")
+  elseif what == "diag" then
+    local diag_status = diagnostics.get_diag_status(node)
+    return diag_status ~= nil and diag_status.value ~= nil
+  elseif what == "opened" then
+    return vim.fn.bufloaded(node.absolute_path) ~= 0
+  end
+
+  return false
+end
+
+---Move to the next node that has a valid status. If none found, don't move.
+---@param where string where to move (forwards or backwards)
+---@param what string type of status
+---@param skip_gitignored boolean default false
+local function move(where, what, skip_gitignored)
+  local first_node_line = core.get_nodes_starting_line()
+  local nodes_by_line = utils.get_nodes_by_line(core.get_explorer().nodes, first_node_line)
+  local iter_start, iter_end, iter_step, cur, first, nex
+
+  local cursor = lib.get_cursor_position()
+  if cursor and cursor[1] < first_node_line then
+    cur = cursor[1]
+  end
+
+  if where == "next" then
+    iter_start, iter_end, iter_step = first_node_line, #nodes_by_line, 1
+  elseif where == "prev" then
+    iter_start, iter_end, iter_step = #nodes_by_line, first_node_line, -1
+  end
+
+  for line = iter_start, iter_end, iter_step do
+    local node = nodes_by_line[line]
+    local valid = status_is_valid(node, what, skip_gitignored)
+
+    if not first and valid then
+      first = line
+    end
+
+    if cursor and line == cursor[1] then
+      cur = line
+    elseif valid and cur then
+      nex = line
+      break
+    end
+  end
+
+  if nex then
+    view.set_cursor { nex, 0 }
+  elseif vim.o.wrapscan and first then
+    view.set_cursor { first, 0 }
+  end
+end
+
+local function expand_node(node)
+  if not node.open then
+    -- Expand the node.
+    -- Should never collapse since we checked open.
+    lib.expand_or_collapse(node)
+  end
+end
+
+--- Move to the next node recursively.
+---@param what string type of status
+---@param skip_gitignored boolean default false
+local function move_next_recursive(what, skip_gitignored)
+  -- If the current node:
+  -- * is a directory
+  -- * and is not the root node
+  -- * and has a git/diag status
+  -- * and is not opened
+  -- expand it.
+  local node_init = lib.get_node_at_cursor()
+  if not node_init then
+    return
+  end
+  local valid = false
+  if node_init.name ~= ".." then -- root node cannot have a status
+    valid = status_is_valid(node_init, what, skip_gitignored)
+  end
+  if node_init.nodes ~= nil and valid and not node_init.open then
+    lib.expand_or_collapse(node_init)
+  end
+
+  move("next", what, skip_gitignored)
+
+  local node_cur = lib.get_node_at_cursor()
+  if not node_cur then
+    return
+  end
+
+  -- If we haven't moved at all at this point, return.
+  if node_init == node_cur then
+    return
+  end
+
+  -- i is used to limit iterations.
+  local i = 0
+  local is_dir = node_cur.nodes ~= nil
+  while is_dir and i < MAX_DEPTH do
+    expand_node(node_cur)
+
+    move("next", what, skip_gitignored)
+
+    -- Save current node.
+    node_cur = lib.get_node_at_cursor()
+    -- Update is_dir.
+    if node_cur then
+      is_dir = node_cur.nodes ~= nil
+    else
+      is_dir = false
+    end
+
+    i = i + 1
+  end
+end
+
+--- Move to the previous node recursively.
+---
+--- move_prev_recursive:
+---
+--- 1) Save current as node_init.
+--  2) Call a non-recursive prev.
+--- 3) If current node is node_init's parent, call move_prev_recursive.
+--- 4) Else:
+--- 4.1) If current node is nil, is node_init (we didn't move), or is a file, return.
+--- 4.2) The current file is a directory, expand it.
+--- 4.3) Find node_init in current window, and move to it (if not found, return).
+---      If node_init is the root node (name = ".."), directly move to position 1.
+--- 4.4) Call a non-recursive prev.
+--- 4.5) Save the current node and start back from 4.1.
+---
+---@param what string type of status
+---@param skip_gitignored boolean default false
+local function move_prev_recursive(what, skip_gitignored)
+  local node_init, node_cur
+
+  -- 1)
+  node_init = lib.get_node_at_cursor()
+  if node_init == nil then
+    return
+  end
+
+  -- 2)
+  move("prev", what, skip_gitignored)
+
+  node_cur = lib.get_node_at_cursor()
+  if node_cur == node_init.parent then
+    -- 3)
+    move_prev_recursive(what, skip_gitignored)
+  else
+    -- i is used to limit iterations.
+    local i = 0
+    while i < MAX_DEPTH do
+      -- 4.1)
+      if
+        node_cur == nil
+        or node_cur == node_init -- we didn't move
+        or not node_cur.nodes -- node is a file
+      then
+        return
+      end
+
+      -- 4.2)
+      local node_dir = node_cur
+      expand_node(node_dir)
+
+      -- 4.3)
+      if node_init.name == ".." then -- root node
+        view.set_cursor { 1, 0 } -- move to root node (position 1)
+      else
+        local node_init_line = utils.find_node_line(node_init)
+        if node_init_line < 0 then
+          return
+        end
+        view.set_cursor { node_init_line, 0 }
+      end
+
+      -- 4.4)
+      move("prev", what, skip_gitignored)
+
+      -- 4.5)
+      node_cur = lib.get_node_at_cursor()
+
+      i = i + 1
+    end
+  end
+end
+
+---@class NavigationItemOpts
+---@field where string
+---@field what string
+
+---@param opts NavigationItemOpts
 ---@return fun()
-function M.fn(where, what)
+function M.fn(opts)
   return function()
-    local node_cur = lib.get_node_at_cursor()
+    local recurse = false
-    local first_node_line = core.get_nodes_starting_line()
+    local skip_gitignored = false
-    local nodes_by_line = utils.get_nodes_by_line(core.get_explorer().nodes, first_node_line)
-    local iter_start, iter_end, iter_step, cur, first, nex
 
-    if where == "next" then
+    -- recurse only valid for git and diag moves.
-      iter_start, iter_end, iter_step = first_node_line, #nodes_by_line, 1
+    if (opts.what == "git" or opts.what == "diag") and opts.recurse ~= nil then
-    elseif where == "prev" then
+      recurse = opts.recurse
-      iter_start, iter_end, iter_step = #nodes_by_line, first_node_line, -1
     end
 
-    for line = iter_start, iter_end, iter_step do
+    if opts.skip_gitignored ~= nil then
-      local node = nodes_by_line[line]
+      skip_gitignored = opts.skip_gitignored
-      local valid = false
-
-      if what == "git" then
-        valid = explorer_node.get_git_status(node) ~= nil
-      elseif what == "diag" then
-        valid = node.diag_status ~= nil
-      elseif what == "opened" then
-        valid = vim.fn.bufloaded(node.absolute_path) ~= 0
-      end
-
-      if not first and valid then
-        first = line
-      end
-
-      if node == node_cur then
-        cur = line
-      elseif valid and cur then
-        nex = line
-        break
-      end
     end
 
-    if nex then
+    if not recurse then
-      view.set_cursor { nex, 0 }
+      move(opts.where, opts.what, skip_gitignored)
-    elseif vim.o.wrapscan and first then
+      return
-      view.set_cursor { first, 0 }
+    end
+
+    if opts.where == "next" then
+      move_next_recursive(opts.what, skip_gitignored)
+    elseif opts.where == "prev" then
+      move_prev_recursive(opts.what, skip_gitignored)
     end
   end
 end

lua/nvim-tree/actions/moves/parent.lua

@@ -1,4 +1,3 @@
-local renderer = require "nvim-tree.renderer"
 local view = require "nvim-tree.view"
 local utils = require "nvim-tree.utils"
 local core = require "nvim-tree.core"
@@ -11,11 +10,16 @@ local M = {}
 function M.fn(should_close)
   should_close = should_close or false
 
+  local explorer = core.get_explorer()
+
   return function(node)
     node = lib.get_last_group_node(node)
     if should_close and node.open then
       node.open = false
-      return renderer.draw()
+      if explorer then
+        explorer.renderer:draw()
+      end
+      return
     end
 
     local parent = utils.get_parent_of_group(node).parent
@@ -31,7 +35,9 @@ function M.fn(should_close)
     view.set_cursor { line + 1, 0 }
     if should_close then
       parent.open = false
-      renderer.draw()
+      if explorer then
+        explorer.renderer:draw()
+      end
     end
   end
 end

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

@@ -6,6 +6,14 @@ local M = {}
 ---@return table
 local function get_formatted_lines(node)
   local stats = node.fs_stat
+  if stats == nil then
+    return {
+      "",
+      "  Can't retrieve file information",
+      "",
+    }
+  end
+
   local fpath = " fullpath: " .. node.absolute_path
   local created_at = " created:  " .. os.date("%x %X", stats.birthtime.sec)
   local modified_at = " modified: " .. os.date("%x %X", stats.mtime.sec)
@@ -48,7 +56,7 @@ end
 
 function M.close_popup()
   if current_popup ~= nil then
-    vim.api.nvim_win_close(current_popup.winnr, { force = true })
+    vim.api.nvim_win_close(current_popup.winnr, true)
     vim.cmd "augroup NvimTreeRemoveFilePopup | au! CursorMoved | augroup END"
 
     current_popup = nil

lua/nvim-tree/actions/node/init.lua

@@ -0,0 +1,14 @@
+local M = {}
+
+M.file_popup = require "nvim-tree.actions.node.file-popup"
+M.open_file = require "nvim-tree.actions.node.open-file"
+M.run_command = require "nvim-tree.actions.node.run-command"
+M.system_open = require "nvim-tree.actions.node.system-open"
+
+function M.setup(opts)
+  require("nvim-tree.actions.node.system-open").setup(opts)
+  require("nvim-tree.actions.node.file-popup").setup(opts)
+  require("nvim-tree.actions.node.open-file").setup(opts)
+end
+
+return M

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

@@ -26,14 +26,20 @@ local function usable_win_ids()
   return vim.tbl_filter(function(id)
     local bufid = vim.api.nvim_win_get_buf(id)
     for option, v in pairs(M.window_picker.exclude) do
-      local ok, option_value = pcall(vim.api.nvim_buf_get_option, bufid, option)
+      local ok, option_value
+      if vim.fn.has "nvim-0.10" == 1 then
+        ok, option_value = pcall(vim.api.nvim_get_option_value, option, { buf = bufid })
+      else
+        ok, option_value = pcall(vim.api.nvim_buf_get_option, bufid, option) ---@diagnostic disable-line: deprecated
+      end
+
       if ok and vim.tbl_contains(v, option_value) then
         return false
       end
     end
 
     local win_config = vim.api.nvim_win_get_config(id)
-    return id ~= tree_winid and win_config.focusable and not win_config.external
+    return id ~= tree_winid and win_config.focusable and not win_config.external or false
   end, win_ids)
 end
 
@@ -83,8 +89,15 @@ local function pick_win_id()
 
   if laststatus == 3 then
     for _, win_id in ipairs(not_selectable) do
-      local ok_status, statusline = pcall(vim.api.nvim_win_get_option, win_id, "statusline")
+      local ok_status, statusline, ok_hl, winhl
-      local ok_hl, winhl = pcall(vim.api.nvim_win_get_option, win_id, "winhl")
+
+      if vim.fn.has "nvim-0.10" == 1 then
+        ok_status, statusline = pcall(vim.api.nvim_get_option_value, "statusline", { win = win_id })
+        ok_hl, winhl = pcall(vim.api.nvim_get_option_value, "winhl", { win = win_id })
+      else
+        ok_status, statusline = pcall(vim.api.nvim_win_get_option, win_id, "statusline") ---@diagnostic disable-line: deprecated
+        ok_hl, winhl = pcall(vim.api.nvim_win_get_option, win_id, "winhl") ---@diagnostic disable-line: deprecated
+      end
 
       win_opts[win_id] = {
         statusline = ok_status and statusline or "",
@@ -92,15 +105,26 @@ local function pick_win_id()
       }
 
       -- Clear statusline for windows not selectable
-      vim.api.nvim_win_set_option(win_id, "statusline", " ")
+      if vim.fn.has "nvim-0.10" == 1 then
+        vim.api.nvim_set_option_value("statusline", " ", { win = win_id })
+      else
+        vim.api.nvim_win_set_option(win_id, "statusline", " ") ---@diagnostic disable-line: deprecated
+      end
     end
   end
 
   -- Setup UI
   for _, id in ipairs(selectable) do
     local char = M.window_picker.chars:sub(i, i)
-    local ok_status, statusline = pcall(vim.api.nvim_win_get_option, id, "statusline")
+
-    local ok_hl, winhl = pcall(vim.api.nvim_win_get_option, id, "winhl")
+    local ok_status, statusline, ok_hl, winhl
+    if vim.fn.has "nvim-0.10" == 1 then
+      ok_status, statusline = pcall(vim.api.nvim_get_option_value, "statusline", { win = id })
+      ok_hl, winhl = pcall(vim.api.nvim_get_option_value, "winhl", { win = id })
+    else
+      ok_status, statusline = pcall(vim.api.nvim_win_get_option, id, "statusline") ---@diagnostic disable-line: deprecated
+      ok_hl, winhl = pcall(vim.api.nvim_win_get_option, id, "winhl") ---@diagnostic disable-line: deprecated
+    end
 
     win_opts[id] = {
       statusline = ok_status and statusline or "",
@@ -108,8 +132,13 @@ local function pick_win_id()
     }
     win_map[char] = id
 
-    vim.api.nvim_win_set_option(id, "statusline", "%=" .. char .. "%=")
+    if vim.fn.has "nvim-0.10" == 1 then
-    vim.api.nvim_win_set_option(id, "winhl", "StatusLine:NvimTreeWindowPicker,StatusLineNC:NvimTreeWindowPicker")
+      vim.api.nvim_set_option_value("statusline", "%=" .. char .. "%=", { win = id })
+      vim.api.nvim_set_option_value("winhl", "StatusLine:NvimTreeWindowPicker,StatusLineNC:NvimTreeWindowPicker", { win = id })
+    else
+      vim.api.nvim_win_set_option(id, "statusline", "%=" .. char .. "%=") ---@diagnostic disable-line: deprecated
+      vim.api.nvim_win_set_option(id, "winhl", "StatusLine:NvimTreeWindowPicker,StatusLineNC:NvimTreeWindowPicker") ---@diagnostic disable-line: deprecated
+    end
 
     i = i + 1
     if i > #M.window_picker.chars then
@@ -128,14 +157,25 @@ local function pick_win_id()
   -- Restore window options
   for _, id in ipairs(selectable) do
     for opt, value in pairs(win_opts[id]) do
-      vim.api.nvim_win_set_option(id, opt, value)
+      if vim.fn.has "nvim-0.10" == 1 then
+        vim.api.nvim_set_option_value(opt, value, { win = id })
+      else
+        vim.api.nvim_win_set_option(id, opt, value) ---@diagnostic disable-line: deprecated
+      end
     end
   end
 
   if laststatus == 3 then
     for _, id in ipairs(not_selectable) do
-      for opt, value in pairs(win_opts[id]) do
+      -- Ensure window still exists at this point
-        vim.api.nvim_win_set_option(id, opt, value)
+      if vim.api.nvim_win_is_valid(id) then
+        for opt, value in pairs(win_opts[id]) do
+          if vim.fn.has "nvim-0.10" == 1 then
+            vim.api.nvim_set_option_value(opt, value, { win = id })
+          else
+            vim.api.nvim_win_set_option(id, opt, value) ---@diagnostic disable-line: deprecated
+          end
+        end
       end
     end
   end
@@ -153,6 +193,9 @@ local function open_file_in_tab(filename)
   if M.quit_on_open then
     view.close()
   end
+  if M.relative_path then
+    filename = utils.path_relative(filename, vim.fn.getcwd())
+  end
   vim.cmd("tabe " .. vim.fn.fnameescape(filename))
 end
 
@@ -160,6 +203,9 @@ local function drop(filename)
   if M.quit_on_open then
     view.close()
   end
+  if M.relative_path then
+    filename = utils.path_relative(filename, vim.fn.getcwd())
+  end
   vim.cmd("drop " .. vim.fn.fnameescape(filename))
 end
 
@@ -167,6 +213,9 @@ local function tab_drop(filename)
   if M.quit_on_open then
     view.close()
   end
+  if M.relative_path then
+    filename = utils.path_relative(filename, vim.fn.getcwd())
+  end
   vim.cmd("tab :drop " .. vim.fn.fnameescape(filename))
 end
 
@@ -258,25 +307,21 @@ local function open_in_new_window(filename, mode)
     -- If `hidden` is not enabled, check if buffer in target window is
     -- modified, and create new split if it is.
     local target_bufid = vim.api.nvim_win_get_buf(target_winid)
-    if vim.api.nvim_buf_get_option(target_bufid, "modified") then
+
+    local modified
+    if vim.fn.has "nvim-0.10" == 1 then
+      modified = vim.api.nvim_get_option_value("modified", { buf = target_bufid })
+    else
+      modified = vim.api.nvim_buf_get_option(target_bufid, "modified") ---@diagnostic disable-line: deprecated
+    end
+
+    if modified then
       if not mode:match "split$" then
         mode = "vsplit"
       end
     end
   end
 
-  local fname = vim.fn.fnameescape(filename)
-  fname = utils.escape_special_chars(fname)
-
-  local cmd
-  if create_new_window then
-    cmd = string.format("%s vsplit %s", new_window_side, fname)
-  elseif mode:match "split$" then
-    cmd = string.format("%s %s", mode, fname)
-  else
-    cmd = string.format("edit %s", fname)
-  end
-
   if (mode == "preview" or mode == "preview_no_picker") and view.View.float.enable then
     -- ignore "WinLeave" autocmd on preview
     -- because the registered "WinLeave"
@@ -286,7 +331,24 @@ local function open_in_new_window(filename, mode)
     set_current_win_no_autocmd(target_winid, { "BufEnter" })
   end
 
-  pcall(vim.cmd, cmd)
+  local fname
+  if M.relative_path then
+    fname = vim.fn.fnameescape(utils.path_relative(filename, vim.fn.getcwd()))
+  else
+    fname = vim.fn.fnameescape(filename)
+  end
+
+  local command
+  if create_new_window then
+    -- generated from vim.api.nvim_parse_cmd("belowright vsplit foo", {})
+    command = { cmd = "vsplit", mods = { split = new_window_side }, args = { fname } }
+  elseif mode:match "split$" then
+    command = { cmd = mode, args = { fname } }
+  else
+    command = { cmd = "edit", args = { fname } }
+  end
+
+  pcall(vim.api.nvim_cmd, command, { output = false })
   lib.set_target_win()
 end
 
@@ -301,33 +363,37 @@ end
 
 local function edit_in_current_buf(filename)
   require("nvim-tree.view").abandon_current_window()
+  if M.relative_path then
+    filename = utils.path_relative(filename, vim.fn.getcwd())
+  end
   vim.cmd("keepalt keepjumps edit " .. vim.fn.fnameescape(filename))
 end
 
 ---@param mode string
 ---@param filename string
 function M.fn(mode, filename)
+  local fname = utils.escape_special_chars(filename)
   if type(mode) ~= "string" then
     mode = ""
   end
 
   if mode == "tabnew" then
-    return open_file_in_tab(filename)
+    return open_file_in_tab(fname)
   end
 
   if mode == "drop" then
-    return drop(filename)
+    return drop(fname)
   end
 
   if mode == "tab_drop" then
-    return tab_drop(filename)
+    return tab_drop(fname)
   end
 
   if mode == "edit_in_place" then
-    return edit_in_current_buf(filename)
+    return edit_in_current_buf(fname)
   end
 
-  local buf_loaded = is_already_loaded(filename)
+  local buf_loaded = is_already_loaded(fname)
 
   local found_win = utils.get_win_buf_from_path(filename)
   if found_win and (mode == "preview" or mode == "preview_no_picker") then
@@ -335,7 +401,7 @@ function M.fn(mode, filename)
   end
 
   if not found_win then
-    open_in_new_window(filename, mode)
+    open_in_new_window(fname, mode)
   else
     vim.api.nvim_set_current_win(found_win)
     vim.bo.bufhidden = ""
@@ -357,6 +423,7 @@ end
 function M.setup(opts)
   M.quit_on_open = opts.actions.open_file.quit_on_open
   M.resize_window = opts.actions.open_file.resize_window
+  M.relative_path = opts.experimental.actions.open_file.relative_path
   if opts.actions.open_file.window_picker.chars then
     opts.actions.open_file.window_picker.chars = tostring(opts.actions.open_file.window_picker.chars):upper()
   end

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

@@ -4,7 +4,7 @@ local utils = require "nvim-tree.utils"
 local M = {}
 
 ---@param node Node
-function M.fn(node)
+local function user(node)
   if #M.config.system_open.cmd == 0 then
     require("nvim-tree.utils").notify.warn "Cannot open file with system application. Unrecognized platform."
     return
@@ -49,20 +49,41 @@ function M.fn(node)
   vim.loop.unref(process.handle)
 end
 
+---@param node Node
+local function native(node)
+  local _, err = vim.ui.open(node.link_to or node.absolute_path)
+
+  -- err only provided on opener executable not found hence logging path is not useful
+  if err then
+    notify.warn(err)
+  end
+end
+
+---@param node Node
+function M.fn(node)
+  M.open(node)
+end
+
+-- TODO always use native once 0.10 is the minimum neovim version
 function M.setup(opts)
   M.config = {}
   M.config.system_open = opts.system_open or {}
 
-  if #M.config.system_open.cmd == 0 then
+  if vim.fn.has "nvim-0.10" == 1 and #M.config.system_open.cmd == 0 then
-    if utils.is_windows then
+    M.open = native
-      M.config.system_open = {
+  else
-        cmd = "cmd",
+    M.open = user
-        args = { "/c", "start", '""' },
+    if #M.config.system_open.cmd == 0 then
-      }
+      if utils.is_windows then
-    elseif utils.is_macos then
+        M.config.system_open = {
-      M.config.system_open.cmd = "open"
+          cmd = "cmd",
-    elseif utils.is_unix then
+          args = { "/c", "start", '""' },
-      M.config.system_open.cmd = "xdg-open"
+        }
+      elseif utils.is_macos then
+        M.config.system_open.cmd = "open"
+      elseif utils.is_unix then
+        M.config.system_open.cmd = "xdg-open"
+      end
     end
   end
 end

lua/nvim-tree/actions/reloaders/reloaders.lua

@@ -1,74 +0,0 @@
-local git = require "nvim-tree.git"
-local view = require "nvim-tree.view"
-local renderer = require "nvim-tree.renderer"
-local explorer_module = require "nvim-tree.explorer"
-local core = require "nvim-tree.core"
-local explorer_node = require "nvim-tree.explorer.node"
-local Iterator = require "nvim-tree.iterators.node-iterator"
-
-local M = {}
-
----@param node Explorer|nil
----@param projects table
----@param unloaded_bufnr number|nil
-local function refresh_nodes(node, projects, unloaded_bufnr)
-  Iterator.builder({ node })
-    :applier(function(n)
-      if n.nodes then
-        local toplevel = git.get_toplevel(n.cwd or n.link_to or n.absolute_path)
-        explorer_module.reload(n, projects[toplevel] or {}, unloaded_bufnr)
-      end
-    end)
-    :recursor(function(n)
-      return n.group_next and { n.group_next } or (n.open and n.nodes)
-    end)
-    :iterate()
-end
-
----@param parent_node Node|nil
----@param projects table
-function M.reload_node_status(parent_node, projects)
-  if parent_node == nil then
-    return
-  end
-
-  local toplevel = git.get_toplevel(parent_node.absolute_path)
-  local status = projects[toplevel] or {}
-  for _, node in ipairs(parent_node.nodes) do
-    explorer_node.update_git_status(node, explorer_node.is_git_ignored(parent_node), status)
-    if node.nodes and #node.nodes > 0 then
-      M.reload_node_status(node, projects)
-    end
-  end
-end
-
-local event_running = false
----@param _ table|nil unused node passed by action
----@param unloaded_bufnr number|nil optional bufnr recently unloaded via BufUnload event
-function M.reload_explorer(_, unloaded_bufnr)
-  if event_running or not core.get_explorer() or vim.v.exiting ~= vim.NIL then
-    return
-  end
-  event_running = true
-
-  local projects = git.reload()
-  refresh_nodes(core.get_explorer(), projects, unloaded_bufnr)
-  if view.is_visible() then
-    renderer.draw(unloaded_bufnr)
-  end
-  event_running = false
-end
-
-function M.reload_git()
-  if not core.get_explorer() or not git.config.git.enable or event_running then
-    return
-  end
-  event_running = true
-
-  local projects = git.reload()
-  M.reload_node_status(core.get_explorer(), projects)
-  renderer.draw()
-  event_running = false
-end
-
-return M

lua/nvim-tree/actions/root/change-dir.lua

@@ -91,7 +91,10 @@ M.force_dirchange = add_profiling_to(function(foldername, should_open_view)
   if should_open_view then
     require("nvim-tree.lib").open()
   else
-    require("nvim-tree.renderer").draw()
+    local explorer = core.get_explorer()
+    if explorer then
+      explorer.renderer:draw()
+    end
   end
 end)
 

lua/nvim-tree/actions/root/init.lua

@@ -0,0 +1,10 @@
+local M = {}
+
+M.change_dir = require "nvim-tree.actions.root.change-dir"
+M.dir_up = require "nvim-tree.actions.root.dir-up"
+
+function M.setup(opts)
+  M.change_dir.setup(opts)
+end
+
+return M

lua/nvim-tree/actions/tree-modifiers/toggles.lua

@@ -1,39 +0,0 @@
-local lib = require "nvim-tree.lib"
-local utils = require "nvim-tree.utils"
-local filters = require "nvim-tree.explorer.filters"
-local reloaders = require "nvim-tree.actions.reloaders.reloaders"
-
-local M = {}
-
-local function reload()
-  local node = lib.get_node_at_cursor()
-  reloaders.reload_explorer()
-  utils.focus_node_or_parent(node)
-end
-
-function M.custom()
-  filters.config.filter_custom = not filters.config.filter_custom
-  reload()
-end
-
-function M.git_ignored()
-  filters.config.filter_git_ignored = not filters.config.filter_git_ignored
-  reload()
-end
-
-function M.git_clean()
-  filters.config.filter_git_clean = not filters.config.filter_git_clean
-  reload()
-end
-
-function M.no_buffer()
-  filters.config.filter_no_buffer = not filters.config.filter_no_buffer
-  reload()
-end
-
-function M.dotfiles()
-  filters.config.filter_dotfiles = not filters.config.filter_dotfiles
-  reload()
-end
-
-return M

lua/nvim-tree/actions/tree/find-file.lua

@@ -24,18 +24,19 @@ function M.fn(opts)
   local bufnr, path
 
   -- (optional) buffer number and path
-  if type(opts.buf) == "nil" then
+  local opts_buf = opts.buf
+  if type(opts_buf) == "nil" then
     bufnr = vim.api.nvim_get_current_buf()
     path = vim.api.nvim_buf_get_name(bufnr)
-  elseif type(opts.buf) == "number" then
+  elseif type(opts_buf) == "number" then
-    if not vim.api.nvim_buf_is_valid(opts.buf) then
+    if not vim.api.nvim_buf_is_valid(opts_buf) then
       return
     end
-    bufnr = tonumber(opts.buf)
+    bufnr = opts_buf
     path = vim.api.nvim_buf_get_name(bufnr)
-  elseif type(opts.buf) == "string" then
+  elseif type(opts_buf) == "string" then
     bufnr = nil
-    path = tostring(opts.buf)
+    path = tostring(opts_buf)
   else
     return
   end
@@ -55,7 +56,7 @@ function M.fn(opts)
   end
 
   -- update root
-  if opts.update_root or M.config.update_focused_file.update_root then
+  if opts.update_root or M.config.update_focused_file.update_root.enable then
     require("nvim-tree").change_root(path, bufnr)
   end
 

lua/nvim-tree/actions/tree/init.lua

@@ -0,0 +1,17 @@
+local M = {}
+
+M.find_file = require "nvim-tree.actions.tree.find-file"
+M.modifiers = require "nvim-tree.actions.tree.modifiers"
+M.open = require "nvim-tree.actions.tree.open"
+M.toggle = require "nvim-tree.actions.tree.toggle"
+M.resize = require "nvim-tree.actions.tree.resize"
+
+function M.setup(opts)
+  M.find_file.setup(opts)
+  M.modifiers.setup(opts)
+  M.open.setup(opts)
+  M.toggle.setup(opts)
+  M.resize.setup(opts)
+end
+
+return M

lua/nvim-tree/actions/tree/modifiers/collapse-all.lua

@@ -1,4 +1,3 @@
-local renderer = require "nvim-tree.renderer"
 local utils = require "nvim-tree.utils"
 local core = require "nvim-tree.core"
 local lib = require "nvim-tree.lib"
@@ -46,7 +45,7 @@ function M.fn(keep_buffers)
     end)
     :iterate()
 
-  renderer.draw()
+  explorer.renderer:draw()
   utils.focus_node_or_parent(node)
 end
 

lua/nvim-tree/actions/tree/modifiers/expand-all.lua

@@ -1,5 +1,4 @@
 local core = require "nvim-tree.core"
-local renderer = require "nvim-tree.renderer"
 local Iterator = require "nvim-tree.iterators.node-iterator"
 local notify = require "nvim-tree.notify"
 local lib = require "nvim-tree.lib"
@@ -65,11 +64,14 @@ end
 
 ---@param base_node table
 function M.fn(base_node)
-  local node = base_node.nodes and base_node or core.get_explorer()
+  local explorer = core.get_explorer()
+  local node = base_node.nodes and base_node or explorer
   if gen_iterator()(node) then
     notify.warn("expansion iteration was halted after " .. M.MAX_FOLDER_DISCOVERY .. " discovered folders")
   end
-  renderer.draw()
+  if explorer then
+    explorer.renderer:draw()
+  end
 end
 
 function M.setup(opts)

lua/nvim-tree/actions/tree/modifiers/init.lua

@@ -0,0 +1,11 @@
+local M = {}
+
+M.collapse_all = require "nvim-tree.actions.tree.modifiers.collapse-all"
+M.expand_all = require "nvim-tree.actions.tree.modifiers.expand-all"
+M.toggles = require "nvim-tree.actions.tree.modifiers.toggles"
+
+function M.setup(opts)
+  M.expand_all.setup(opts)
+end
+
+return M

lua/nvim-tree/actions/tree/modifiers/toggles.lua

@@ -0,0 +1,72 @@
+local lib = require "nvim-tree.lib"
+local utils = require "nvim-tree.utils"
+local core = require "nvim-tree.core"
+local M = {}
+
+---@param explorer Explorer
+local function reload(explorer)
+  local node = lib.get_node_at_cursor()
+  explorer:reload_explorer()
+  utils.focus_node_or_parent(node)
+end
+
+local function wrap_explorer(fn)
+  return function(...)
+    local explorer = core.get_explorer()
+    if explorer then
+      return fn(explorer, ...)
+    end
+  end
+end
+
+---@param explorer Explorer
+local function custom(explorer)
+  explorer.filters.config.filter_custom = not explorer.filters.config.filter_custom
+  reload(explorer)
+end
+
+---@param explorer Explorer
+local function git_ignored(explorer)
+  explorer.filters.config.filter_git_ignored = not explorer.filters.config.filter_git_ignored
+  reload(explorer)
+end
+
+---@param explorer Explorer
+local function git_clean(explorer)
+  explorer.filters.config.filter_git_clean = not explorer.filters.config.filter_git_clean
+  reload(explorer)
+end
+
+---@param explorer Explorer
+local function no_buffer(explorer)
+  explorer.filters.config.filter_no_buffer = not explorer.filters.config.filter_no_buffer
+  reload(explorer)
+end
+
+---@param explorer Explorer
+local function no_bookmark(explorer)
+  explorer.filters.config.filter_no_bookmark = not explorer.filters.config.filter_no_bookmark
+  reload(explorer)
+end
+
+---@param explorer Explorer
+local function dotfiles(explorer)
+  explorer.filters.config.filter_dotfiles = not explorer.filters.config.filter_dotfiles
+  reload(explorer)
+end
+
+---@param explorer Explorer
+local function enable(explorer)
+  explorer.filters.config.enable = not explorer.filters.config.enable
+  reload(explorer)
+end
+
+M.custom = wrap_explorer(custom)
+M.git_ignored = wrap_explorer(git_ignored)
+M.git_clean = wrap_explorer(git_clean)
+M.no_buffer = wrap_explorer(no_buffer)
+M.no_bookmark = wrap_explorer(no_bookmark)
+M.dotfiles = wrap_explorer(dotfiles)
+M.enable = wrap_explorer(enable)
+
+return M

lua/nvim-tree/actions/tree/resize.lua

@@ -0,0 +1,51 @@
+local view = require "nvim-tree.view"
+
+local M = {}
+
+---Resize the tree, persisting the new size.
+---@param opts ApiTreeResizeOpts|nil
+function M.fn(opts)
+  if opts == nil then
+    -- reset to config values
+    view.configure_width()
+    view.resize()
+    return
+  end
+
+  local options = opts or {}
+  local width_cfg = options.width
+
+  if width_cfg ~= nil then
+    view.configure_width(width_cfg)
+    view.resize()
+    return
+  end
+
+  if not view.is_width_determined() then
+    -- {absolute} and {relative} do nothing when {width} is a function.
+    return
+  end
+
+  local absolute = options.absolute
+  if type(absolute) == "number" then
+    view.resize(absolute)
+    return
+  end
+
+  local relative = options.relative
+  if type(relative) == "number" then
+    local relative_size = tostring(relative)
+    if relative > 0 then
+      relative_size = "+" .. relative_size
+    end
+
+    view.resize(relative_size)
+    return
+  end
+end
+
+function M.setup(opts)
+  M.config = opts or {}
+end
+
+return M

lua/nvim-tree/api.lua

@@ -1,3 +1,12 @@
+local lib = require "nvim-tree.lib"
+local core = require "nvim-tree.core"
+local view = require "nvim-tree.view"
+local utils = require "nvim-tree.utils"
+local actions = require "nvim-tree.actions"
+local appearance_diagnostics = require "nvim-tree.appearance.diagnostics"
+local events = require "nvim-tree.events"
+local help = require "nvim-tree.help"
+local keymap = require "nvim-tree.keymap"
 local notify = require "nvim-tree.notify"
 
 local Api = {
@@ -26,11 +35,13 @@ local Api = {
     mappings = {},
   },
   commands = {},
+  diagnostics = {},
 }
 
---- Do nothing when setup not called.
+--- Print error when setup not called.
 --- f function to invoke
 ---@param f function
+---@return fun(...) : any
 local function wrap(f)
   return function(...)
     if vim.g.NvimTreeSetup == 1 then
@@ -41,13 +52,13 @@ local function wrap(f)
   end
 end
 
----Inject the node as the first argument if absent.
+---Inject the node as the first argument if present otherwise do nothing.
 ---@param fn function function to invoke
 local function wrap_node(fn)
   return function(node, ...)
-    node = node or require("nvim-tree.lib").get_node_at_cursor()
+    node = node or lib.get_node_at_cursor()
     if node then
-      fn(node, ...)
+      return fn(node, ...)
     end
   end
 end
@@ -56,11 +67,38 @@ end
 ---@param fn function function to invoke
 local function wrap_node_or_nil(fn)
   return function(node, ...)
-    node = node or require("nvim-tree.lib").get_node_at_cursor()
+    node = node or lib.get_node_at_cursor()
-    fn(node, ...)
+    return fn(node, ...)
   end
 end
 
+---Invoke a method on the singleton explorer.
+---Print error when setup not called.
+---@param explorer_method string explorer method name
+---@return fun(...) : any
+local function wrap_explorer(explorer_method)
+  return wrap(function(...)
+    local explorer = core.get_explorer()
+    if explorer then
+      return explorer[explorer_method](explorer, ...)
+    end
+  end)
+end
+
+---Invoke a member's method on the singleton explorer.
+---Print error when setup not called.
+---@param explorer_member string explorer member name
+---@param member_method string method name to invoke on member
+---@return fun(...) : any
+local function wrap_explorer_member(explorer_member, member_method)
+  return wrap(function(...)
+    local explorer = core.get_explorer()
+    if explorer then
+      return explorer[explorer_member][member_method](explorer[explorer_member], ...)
+    end
+  end)
+end
+
 ---@class ApiTreeOpenOpts
 ---@field path string|nil path
 ---@field current_window boolean|nil default false
@@ -68,7 +106,8 @@ end
 ---@field find_file boolean|nil default false
 ---@field update_root boolean|nil default false
 
-Api.tree.open = wrap(require("nvim-tree.actions.tree.open").fn)
+Api.tree.open = wrap(actions.tree.open.fn)
+Api.tree.focus = Api.tree.open
 
 ---@class ApiTreeToggleOpts
 ---@field path string|nil
@@ -78,19 +117,18 @@ Api.tree.open = wrap(require("nvim-tree.actions.tree.open").fn)
 ---@field update_root boolean|nil default false
 ---@field focus boolean|nil default true
 
-Api.tree.toggle = wrap(require("nvim-tree.actions.tree.toggle").fn)
+Api.tree.toggle = wrap(actions.tree.toggle.fn)
+Api.tree.close = wrap(view.close)
+Api.tree.close_in_this_tab = wrap(view.close_this_tab_only)
+Api.tree.close_in_all_tabs = wrap(view.close_all_tabs)
+Api.tree.reload = wrap_explorer "reload_explorer"
 
-Api.tree.close = wrap(require("nvim-tree.view").close)
+---@class ApiTreeResizeOpts
+---@field width string|function|number|table|nil
+---@field absolute number|nil
+---@field relative number|nil
 
-Api.tree.close_in_this_tab = wrap(require("nvim-tree.view").close_this_tab_only)
+Api.tree.resize = wrap(actions.tree.resize.fn)
-
-Api.tree.close_in_all_tabs = wrap(require("nvim-tree.view").close_all_tabs)
-
-Api.tree.focus = wrap(function()
-  Api.tree.open()
-end)
-
-Api.tree.reload = wrap(require("nvim-tree.actions.reloaders.reloaders").reload_explorer)
 
 Api.tree.change_root = wrap(function(...)
   require("nvim-tree").change_dir(...)
@@ -98,17 +136,15 @@ end)
 
 Api.tree.change_root_to_node = wrap_node(function(node)
   if node.name == ".." then
-    require("nvim-tree.actions.root.change-dir").fn ".."
+    actions.root.change_dir.fn ".."
   elseif node.nodes ~= nil then
-    require("nvim-tree.actions.root.change-dir").fn(require("nvim-tree.lib").get_last_group_node(node).absolute_path)
+    actions.root.change_dir.fn(lib.get_last_group_node(node).absolute_path)
   end
 end)
 
-Api.tree.change_root_to_parent = wrap_node(require("nvim-tree.actions.root.dir-up").fn)
+Api.tree.change_root_to_parent = wrap_node(actions.root.dir_up.fn)
-
+Api.tree.get_node_under_cursor = wrap(lib.get_node_at_cursor)
-Api.tree.get_node_under_cursor = wrap(require("nvim-tree.lib").get_node_at_cursor)
+Api.tree.get_nodes = wrap(lib.get_nodes)
-
-Api.tree.get_nodes = wrap(require("nvim-tree.lib").get_nodes)
 
 ---@class ApiTreeFindFileOpts
 ---@field buf string|number|nil
@@ -118,55 +154,48 @@ Api.tree.get_nodes = wrap(require("nvim-tree.lib").get_nodes)
 ---@field update_root boolean|nil default false
 ---@field focus boolean|nil default false
 
-Api.tree.find_file = wrap(require("nvim-tree.actions.tree.find-file").fn)
+Api.tree.find_file = wrap(actions.tree.find_file.fn)
-
+Api.tree.search_node = wrap(actions.finders.search_node.fn)
-Api.tree.search_node = wrap(require("nvim-tree.actions.finders.search-node").fn)
+Api.tree.collapse_all = wrap(actions.tree.modifiers.collapse_all.fn)
-
+Api.tree.expand_all = wrap_node(actions.tree.modifiers.expand_all.fn)
-Api.tree.collapse_all = wrap(require("nvim-tree.actions.tree-modifiers.collapse-all").fn)
+Api.tree.toggle_enable_filters = wrap(actions.tree.modifiers.toggles.enable)
-
+Api.tree.toggle_gitignore_filter = wrap(actions.tree.modifiers.toggles.git_ignored)
-Api.tree.expand_all = wrap_node(require("nvim-tree.actions.tree-modifiers.expand-all").fn)
+Api.tree.toggle_git_clean_filter = wrap(actions.tree.modifiers.toggles.git_clean)
-
+Api.tree.toggle_no_buffer_filter = wrap(actions.tree.modifiers.toggles.no_buffer)
-Api.tree.toggle_gitignore_filter = wrap(require("nvim-tree.actions.tree-modifiers.toggles").git_ignored)
+Api.tree.toggle_custom_filter = wrap(actions.tree.modifiers.toggles.custom)
-
+Api.tree.toggle_hidden_filter = wrap(actions.tree.modifiers.toggles.dotfiles)
-Api.tree.toggle_git_clean_filter = wrap(require("nvim-tree.actions.tree-modifiers.toggles").git_clean)
+Api.tree.toggle_no_bookmark_filter = wrap(actions.tree.modifiers.toggles.no_bookmark)
-
+Api.tree.toggle_help = wrap(help.toggle)
-Api.tree.toggle_no_buffer_filter = wrap(require("nvim-tree.actions.tree-modifiers.toggles").no_buffer)
+Api.tree.is_tree_buf = wrap(utils.is_nvim_tree_buf)
-
-Api.tree.toggle_custom_filter = wrap(require("nvim-tree.actions.tree-modifiers.toggles").custom)
-
-Api.tree.toggle_hidden_filter = wrap(require("nvim-tree.actions.tree-modifiers.toggles").dotfiles)
-
-Api.tree.toggle_help = wrap(require("nvim-tree.help").toggle)
-
-Api.tree.is_tree_buf = wrap(require("nvim-tree.utils").is_nvim_tree_buf)
 
 ---@class ApiTreeIsVisibleOpts
 ---@field tabpage number|nil
 ---@field any_tabpage boolean|nil default false
 
-Api.tree.is_visible = wrap(require("nvim-tree.view").is_visible)
+Api.tree.is_visible = wrap(view.is_visible)
 
 ---@class ApiTreeWinIdOpts
 ---@field tabpage number|nil default nil
 
-Api.tree.winid = wrap(require("nvim-tree.view").winid)
+Api.tree.winid = wrap(view.winid)
 
-Api.fs.create = wrap_node_or_nil(require("nvim-tree.actions.fs.create-file").fn)
+Api.fs.create = wrap_node_or_nil(actions.fs.create_file.fn)
-Api.fs.remove = wrap_node(require("nvim-tree.actions.fs.remove-file").fn)
+Api.fs.remove = wrap_node(actions.fs.remove_file.fn)
-Api.fs.trash = wrap_node(require("nvim-tree.actions.fs.trash").fn)
+Api.fs.trash = wrap_node(actions.fs.trash.fn)
-Api.fs.rename_node = wrap_node(require("nvim-tree.actions.fs.rename-file").fn ":t")
+Api.fs.rename_node = wrap_node(actions.fs.rename_file.fn ":t")
-Api.fs.rename = wrap_node(require("nvim-tree.actions.fs.rename-file").fn ":t")
+Api.fs.rename = wrap_node(actions.fs.rename_file.fn ":t")
-Api.fs.rename_sub = wrap_node(require("nvim-tree.actions.fs.rename-file").fn ":p:h")
+Api.fs.rename_sub = wrap_node(actions.fs.rename_file.fn ":p:h")
-Api.fs.rename_basename = wrap_node(require("nvim-tree.actions.fs.rename-file").fn ":t:r")
+Api.fs.rename_basename = wrap_node(actions.fs.rename_file.fn ":t:r")
-Api.fs.rename_full = wrap_node(require("nvim-tree.actions.fs.rename-file").fn ":p")
+Api.fs.rename_full = wrap_node(actions.fs.rename_file.fn ":p")
-Api.fs.cut = wrap_node(require("nvim-tree.actions.fs.copy-paste").cut)
+Api.fs.cut = wrap_node(wrap_explorer_member("clipboard", "cut"))
-Api.fs.paste = wrap_node(require("nvim-tree.actions.fs.copy-paste").paste)
+Api.fs.paste = wrap_node(wrap_explorer_member("clipboard", "paste"))
-Api.fs.clear_clipboard = wrap(require("nvim-tree.actions.fs.copy-paste").clear_clipboard)
+Api.fs.clear_clipboard = wrap_explorer_member("clipboard", "clear_clipboard")
-Api.fs.print_clipboard = wrap(require("nvim-tree.actions.fs.copy-paste").print_clipboard)
+Api.fs.print_clipboard = wrap_explorer_member("clipboard", "print_clipboard")
-Api.fs.copy.node = wrap_node(require("nvim-tree.actions.fs.copy-paste").copy)
+Api.fs.copy.node = wrap_node(wrap_explorer_member("clipboard", "copy"))
-Api.fs.copy.absolute_path = wrap_node(require("nvim-tree.actions.fs.copy-paste").copy_absolute_path)
+Api.fs.copy.absolute_path = wrap_node(wrap_explorer_member("clipboard", "copy_absolute_path"))
-Api.fs.copy.filename = wrap_node(require("nvim-tree.actions.fs.copy-paste").copy_filename)
+Api.fs.copy.filename = wrap_node(wrap_explorer_member("clipboard", "copy_filename"))
-Api.fs.copy.relative_path = wrap_node(require("nvim-tree.actions.fs.copy-paste").copy_path)
+Api.fs.copy.basename = wrap_node(wrap_explorer_member("clipboard", "copy_basename"))
+Api.fs.copy.relative_path = wrap_node(wrap_explorer_member("clipboard", "copy_path"))
 
 ---@param mode string
 ---@param node table
@@ -175,18 +204,18 @@ local function edit(mode, node)
   if node.link_to and not node.nodes then
     path = node.link_to
   end
-  require("nvim-tree.actions.node.open-file").fn(mode, path)
+  actions.node.open_file.fn(mode, path)
 end
 
 ---@param mode string
 ---@return fun(node: table)
-local function open_or_expand_or_dir_up(mode)
+local function open_or_expand_or_dir_up(mode, toggle_group)
   return function(node)
     if node.name == ".." then
-      require("nvim-tree.actions.root.change-dir").fn ".."
+      actions.root.change_dir.fn ".."
     elseif node.nodes then
-      require("nvim-tree.lib").expand_or_collapse(node)
+      lib.expand_or_collapse(node, toggle_group)
-    else
+    elseif not toggle_group then
       edit(mode, node)
     end
   end
@@ -200,53 +229,57 @@ Api.node.open.no_window_picker = wrap_node(open_or_expand_or_dir_up "edit_no_pic
 Api.node.open.vertical = wrap_node(open_or_expand_or_dir_up "vsplit")
 Api.node.open.horizontal = wrap_node(open_or_expand_or_dir_up "split")
 Api.node.open.tab = wrap_node(open_or_expand_or_dir_up "tabnew")
+Api.node.open.toggle_group_empty = wrap_node(open_or_expand_or_dir_up("toggle_group_empty", true))
 Api.node.open.preview = wrap_node(open_or_expand_or_dir_up "preview")
 Api.node.open.preview_no_picker = wrap_node(open_or_expand_or_dir_up "preview_no_picker")
 
-Api.node.show_info_popup = wrap_node(require("nvim-tree.actions.node.file-popup").toggle_file_info)
+Api.node.show_info_popup = wrap_node(actions.node.file_popup.toggle_file_info)
-Api.node.run.cmd = wrap_node(require("nvim-tree.actions.node.run-command").run_file_command)
+Api.node.run.cmd = wrap_node(actions.node.run_command.run_file_command)
-Api.node.run.system = wrap_node(require("nvim-tree.actions.node.system-open").fn)
+Api.node.run.system = wrap_node(actions.node.system_open.fn)
-Api.node.navigate.sibling.next = wrap_node(require("nvim-tree.actions.moves.sibling").fn "next")
-Api.node.navigate.sibling.prev = wrap_node(require("nvim-tree.actions.moves.sibling").fn "prev")
-Api.node.navigate.sibling.first = wrap_node(require("nvim-tree.actions.moves.sibling").fn "first")
-Api.node.navigate.sibling.last = wrap_node(require("nvim-tree.actions.moves.sibling").fn "last")
-Api.node.navigate.parent = wrap_node(require("nvim-tree.actions.moves.parent").fn(false))
-Api.node.navigate.parent_close = wrap_node(require("nvim-tree.actions.moves.parent").fn(true))
-Api.node.navigate.git.next = wrap_node(require("nvim-tree.actions.moves.item").fn("next", "git"))
-Api.node.navigate.git.prev = wrap_node(require("nvim-tree.actions.moves.item").fn("prev", "git"))
-Api.node.navigate.diagnostics.next = wrap_node(require("nvim-tree.actions.moves.item").fn("next", "diag"))
-Api.node.navigate.diagnostics.prev = wrap_node(require("nvim-tree.actions.moves.item").fn("prev", "diag"))
-Api.node.navigate.opened.next = wrap_node(require("nvim-tree.actions.moves.item").fn("next", "opened"))
-Api.node.navigate.opened.prev = wrap_node(require("nvim-tree.actions.moves.item").fn("prev", "opened"))
 
-Api.git.reload = wrap(require("nvim-tree.actions.reloaders.reloaders").reload_git)
+Api.node.navigate.sibling.next = wrap_node(actions.moves.sibling.fn "next")
+Api.node.navigate.sibling.prev = wrap_node(actions.moves.sibling.fn "prev")
+Api.node.navigate.sibling.first = wrap_node(actions.moves.sibling.fn "first")
+Api.node.navigate.sibling.last = wrap_node(actions.moves.sibling.fn "last")
+Api.node.navigate.parent = wrap_node(actions.moves.parent.fn(false))
+Api.node.navigate.parent_close = wrap_node(actions.moves.parent.fn(true))
+Api.node.navigate.git.next = wrap_node(actions.moves.item.fn { where = "next", what = "git" })
+Api.node.navigate.git.next_skip_gitignored = wrap_node(actions.moves.item.fn { where = "next", what = "git", skip_gitignored = true })
+Api.node.navigate.git.next_recursive = wrap_node(actions.moves.item.fn { where = "next", what = "git", recurse = true })
+Api.node.navigate.git.prev = wrap_node(actions.moves.item.fn { where = "prev", what = "git" })
+Api.node.navigate.git.prev_skip_gitignored = wrap_node(actions.moves.item.fn { where = "prev", what = "git", skip_gitignored = true })
+Api.node.navigate.git.prev_recursive = wrap_node(actions.moves.item.fn { where = "prev", what = "git", recurse = true })
+Api.node.navigate.diagnostics.next = wrap_node(actions.moves.item.fn { where = "next", what = "diag" })
+Api.node.navigate.diagnostics.next_recursive = wrap_node(actions.moves.item.fn { where = "next", what = "diag", recurse = true })
+Api.node.navigate.diagnostics.prev = wrap_node(actions.moves.item.fn { where = "prev", what = "diag" })
+Api.node.navigate.diagnostics.prev_recursive = wrap_node(actions.moves.item.fn { where = "prev", what = "diag", recurse = true })
+Api.node.navigate.opened.next = wrap_node(actions.moves.item.fn { where = "next", what = "opened" })
+Api.node.navigate.opened.prev = wrap_node(actions.moves.item.fn { where = "prev", what = "opened" })
 
-Api.events.subscribe = require("nvim-tree.events").subscribe
+Api.git.reload = wrap_explorer "reload_git"
-Api.events.Event = require("nvim-tree.events").Event
 
-Api.live_filter.start = wrap(require("nvim-tree.live-filter").start_filtering)
+Api.events.subscribe = events.subscribe
-Api.live_filter.clear = wrap(require("nvim-tree.live-filter").clear_filter)
+Api.events.Event = events.Event
 
-Api.marks.get = wrap_node(require("nvim-tree.marks").get_mark)
+Api.live_filter.start = wrap_explorer_member("live_filter", "start_filtering")
-Api.marks.list = wrap(require("nvim-tree.marks").get_marks)
+Api.live_filter.clear = wrap_explorer_member("live_filter", "clear_filter")
-Api.marks.toggle = wrap_node(require("nvim-tree.marks").toggle_mark)
-Api.marks.clear = wrap(require("nvim-tree.marks").clear_marks)
-Api.marks.bulk.delete = wrap(require("nvim-tree.marks.bulk-delete").bulk_delete)
-Api.marks.bulk.trash = wrap(require("nvim-tree.marks.bulk-trash").bulk_trash)
-Api.marks.bulk.move = wrap(require("nvim-tree.marks.bulk-move").bulk_move)
-Api.marks.navigate.next = wrap(require("nvim-tree.marks.navigation").next)
-Api.marks.navigate.prev = wrap(require("nvim-tree.marks.navigation").prev)
-Api.marks.navigate.select = wrap(require("nvim-tree.marks.navigation").select)
 
-Api.config.mappings.default_on_attach = require("nvim-tree.keymap").default_on_attach
+Api.marks.get = wrap_node(wrap_explorer_member("marks", "get"))
+Api.marks.list = wrap_explorer_member("marks", "list")
+Api.marks.toggle = wrap_node(wrap_explorer_member("marks", "toggle"))
+Api.marks.clear = wrap_explorer_member("marks", "clear")
+Api.marks.bulk.delete = wrap_explorer_member("marks", "bulk_delete")
+Api.marks.bulk.trash = wrap_explorer_member("marks", "bulk_trash")
+Api.marks.bulk.move = wrap_explorer_member("marks", "bulk_move")
+Api.marks.navigate.next = wrap_explorer_member("marks", "navigate_next")
+Api.marks.navigate.prev = wrap_explorer_member("marks", "navigate_prev")
+Api.marks.navigate.select = wrap_explorer_member("marks", "navigate_select")
 
-Api.config.mappings.get_keymap = wrap(function()
+Api.config.mappings.get_keymap = wrap(keymap.get_keymap)
-  return require("nvim-tree.keymap").get_keymap()
+Api.config.mappings.get_keymap_default = wrap(keymap.get_keymap_default)
-end)
+Api.config.mappings.default_on_attach = keymap.default_on_attach
 
-Api.config.mappings.get_keymap_default = wrap(function()
+Api.diagnostics.hi_test = wrap(appearance_diagnostics.hi_test)
-  return require("nvim-tree.keymap").get_keymap_default()
-end)
 
 Api.commands.get = wrap(function()
   return require("nvim-tree.commands").get()

lua/nvim-tree/appearance/diagnostics.lua

@@ -0,0 +1,141 @@
+local appearance = require "nvim-tree.appearance"
+
+-- others with name and links less than this arbitrary value are short
+local SHORT_LEN = 50
+
+local M = {}
+
+---@class HighlightDisplay for :NvimTreeHiTest
+---@field group string nvim-tree highlight group name
+---@field links string link chain to a concretely defined group
+---@field def string :hi concrete definition after following any links
+local HighlightDisplay = {}
+
+---@param group string nvim-tree highlight group name
+---@return HighlightDisplay
+function HighlightDisplay:new(group)
+  local o = {}
+  setmetatable(o, self)
+  self.__index = self
+
+  o.group = group
+  local concrete = o.group
+
+  -- maybe follow links
+  local links = {}
+  local link = vim.api.nvim_get_hl(0, { name = o.group }).link
+  while link do
+    table.insert(links, link)
+    concrete = link
+    link = vim.api.nvim_get_hl(0, { name = link }).link
+  end
+  o.links = table.concat(links, " ")
+
+  -- concrete definition
+  local ok, res = pcall(vim.api.nvim_cmd, { cmd = "highlight", args = { concrete } }, { output = true })
+  if ok and type(res) == "string" then
+    o.def = res:gsub(".*xxx *", "")
+  else
+    o.def = ""
+  end
+
+  return o
+end
+
+---Render one group.
+---@param bufnr number to render in
+---@param fmt string format string for group, links, def
+---@param l number line number to render at
+---@return number l next line number
+function HighlightDisplay:render(bufnr, fmt, l)
+  local text = string.format(fmt, self.group, self.links, self.def)
+
+  vim.api.nvim_buf_set_lines(bufnr, l, -1, true, { text })
+  vim.api.nvim_buf_add_highlight(bufnr, -1, self.group, l, 0, #self.group)
+
+  return l + 1
+end
+
+---Render many groups.
+---@param header string before with underline line
+---@param displays HighlightDisplay[] highlight group
+---@param bufnr number to render in
+---@param l number line number to start at
+---@return number l next line number
+local function render_displays(header, displays, bufnr, l)
+  local max_group_len = 0
+  local max_links_len = 0
+
+  -- build all highlight groups, using name only
+  for _, display in ipairs(displays) do
+    max_group_len = math.max(max_group_len, #display.group)
+    max_links_len = math.max(max_links_len, #display.links)
+  end
+
+  -- header
+  vim.api.nvim_buf_set_lines(bufnr, l, -1, true, { header, (header:gsub(".", "-")) })
+  l = l + 2
+
+  -- render and highlight
+  local fmt = string.format("%%-%d.%ds %%-%d.%ds %%s", max_group_len, max_group_len, max_links_len, max_links_len)
+  for _, display in ipairs(displays) do
+    l = display:render(bufnr, fmt, l)
+  end
+
+  return l
+end
+
+---Run a test similar to :so $VIMRUNTIME/syntax/hitest.vim
+---Display all nvim-tree and neovim highlight groups, their link chain and actual definition
+function M.hi_test()
+  -- create a buffer
+  local bufnr = vim.api.nvim_create_buf(false, true)
+
+  local l = 0
+
+  -- nvim-tree groups, ordered
+  local displays = {}
+  for _, highlight_group in ipairs(appearance.HIGHLIGHT_GROUPS) do
+    local display = HighlightDisplay:new(highlight_group.group)
+    table.insert(displays, display)
+  end
+  l = render_displays("nvim-tree", displays, bufnr, l)
+
+  vim.api.nvim_buf_set_lines(bufnr, l, -1, true, { "" })
+  l = l + 1
+
+  -- built in groups, ordered opaquely by nvim
+  local displays_short, displays_long = {}, {}
+  local ok, out = pcall(vim.api.nvim_cmd, { cmd = "highlight" }, { output = true })
+  if ok then
+    for group in string.gmatch(out, "(%w*)%s+xxx") do
+      if group:find("NvimTree", 1, true) ~= 1 then
+        local display = HighlightDisplay:new(group)
+        if #display.group + #display.links > SHORT_LEN then
+          table.insert(displays_long, display)
+        else
+          table.insert(displays_short, display)
+        end
+      end
+    end
+  end
+
+  -- short ones first
+  l = render_displays("other, short", displays_short, bufnr, l)
+  vim.api.nvim_buf_set_lines(bufnr, l, -1, true, { "" })
+  l = l + 1
+
+  -- long
+  render_displays("other, long", displays_long, bufnr, l)
+
+  -- finalise and focus the buffer
+  if vim.fn.has "nvim-0.10" == 1 then
+    vim.api.nvim_set_option_value("modifiable", false, { buf = bufnr })
+  else
+    vim.api.nvim_buf_set_option(bufnr, "modifiable", false) ---@diagnostic disable-line: deprecated
+  end
+
+  vim.cmd.buffer(bufnr)
+end
+
+return M

lua/nvim-tree/appearance/init.lua

@@ -0,0 +1,210 @@
+local M = {}
+
+---@class HighlightGroup
+---@field group string
+---@field link string|nil
+---@field def string|nil
+
+---@type HighlightGroup[]
+-- All highlight groups: linked or directly defined.
+-- Please add new groups to help and preserve order.
+-- Please avoid directly defined groups to preserve accessibility for TUI.
+M.HIGHLIGHT_GROUPS = {
+
+  -- Standard
+  { group = "NvimTreeNormal", link = "Normal" },
+  { group = "NvimTreeNormalFloat", link = "NormalFloat" },
+  { group = "NvimTreeNormalFloatBorder", link = "FloatBorder" },
+  { group = "NvimTreeNormalNC", link = "NvimTreeNormal" },
+
+  { group = "NvimTreeLineNr", link = "LineNr" },
+  { group = "NvimTreeWinSeparator", link = "WinSeparator" },
+  { group = "NvimTreeEndOfBuffer", link = "EndOfBuffer" },
+  { group = "NvimTreePopup", link = "Normal" },
+  { group = "NvimTreeSignColumn", link = "NvimTreeNormal" },
+
+  { group = "NvimTreeCursorColumn", link = "CursorColumn" },
+  { group = "NvimTreeCursorLine", link = "CursorLine" },
+  { group = "NvimTreeCursorLineNr", link = "CursorLineNr" },
+
+  { group = "NvimTreeStatusLine", link = "StatusLine" },
+  { group = "NvimTreeStatusLineNC", link = "StatusLineNC" },
+
+  -- File Text
+  { group = "NvimTreeExecFile", link = "Question" },
+  { group = "NvimTreeImageFile", link = "Question" },
+  { group = "NvimTreeSpecialFile", link = "Title" },
+  { group = "NvimTreeSymlink", link = "Underlined" },
+
+  -- Folder Text
+  { group = "NvimTreeRootFolder", link = "Title" },
+  { group = "NvimTreeFolderName", link = "Directory" },
+  { group = "NvimTreeEmptyFolderName", link = "Directory" },
+  { group = "NvimTreeOpenedFolderName", link = "Directory" },
+  { group = "NvimTreeSymlinkFolderName", link = "Directory" },
+
+  -- File Icons
+  { group = "NvimTreeFileIcon", link = "NvimTreeNormal" },
+  { group = "NvimTreeSymlinkIcon", link = "NvimTreeNormal" },
+
+  -- Folder Icons
+  { group = "NvimTreeFolderIcon", def = "guifg=#8094b4 ctermfg=Blue" },
+  { group = "NvimTreeOpenedFolderIcon", link = "NvimTreeFolderIcon" },
+  { group = "NvimTreeClosedFolderIcon", link = "NvimTreeFolderIcon" },
+  { group = "NvimTreeFolderArrowClosed", link = "NvimTreeIndentMarker" },
+  { group = "NvimTreeFolderArrowOpen", link = "NvimTreeIndentMarker" },
+
+  -- Indent
+  { group = "NvimTreeIndentMarker", link = "NvimTreeFolderIcon" },
+
+  -- Picker
+  { group = "NvimTreeWindowPicker", def = "guifg=#ededed guibg=#4493c8 gui=bold ctermfg=White ctermbg=DarkBlue" },
+
+  -- LiveFilter
+  { group = "NvimTreeLiveFilterPrefix", link = "PreProc" },
+  { group = "NvimTreeLiveFilterValue", link = "ModeMsg" },
+
+  -- Clipboard
+  { group = "NvimTreeCutHL", link = "SpellBad" },
+  { group = "NvimTreeCopiedHL", link = "SpellRare" },
+
+  -- Bookmark
+  { group = "NvimTreeBookmarkIcon", link = "NvimTreeFolderIcon" },
+  { group = "NvimTreeBookmarkHL", link = "SpellLocal" },
+
+  -- Modified
+  { group = "NvimTreeModifiedIcon", link = "Type" },
+  { group = "NvimTreeModifiedFileHL", link = "NvimTreeModifiedIcon" },
+  { group = "NvimTreeModifiedFolderHL", link = "NvimTreeModifiedFileHL" },
+
+  -- Hidden
+  { group = "NvimTreeHiddenIcon", link = "Conceal" },
+  { group = "NvimTreeHiddenFileHL", link = "NvimTreeHiddenIcon" },
+  { group = "NvimTreeHiddenFolderHL", link = "NvimTreeHiddenFileHL" },
+
+  -- Hidden Display
+  { group = "NvimTreeHiddenDisplay", link = "Conceal" },
+
+  -- Opened
+  { group = "NvimTreeOpenedHL", link = "Special" },
+
+  -- Git Icon
+  { group = "NvimTreeGitDeletedIcon", link = "Statement" },
+  { group = "NvimTreeGitDirtyIcon", link = "Statement" },
+  { group = "NvimTreeGitIgnoredIcon", link = "Comment" },
+  { group = "NvimTreeGitMergeIcon", link = "Constant" },
+  { group = "NvimTreeGitNewIcon", link = "PreProc" },
+  { group = "NvimTreeGitRenamedIcon", link = "PreProc" },
+  { group = "NvimTreeGitStagedIcon", link = "Constant" },
+
+  -- Git File Highlight
+  { group = "NvimTreeGitFileDeletedHL", link = "NvimTreeGitDeletedIcon" },
+  { group = "NvimTreeGitFileDirtyHL", link = "NvimTreeGitDirtyIcon" },
+  { group = "NvimTreeGitFileIgnoredHL", link = "NvimTreeGitIgnoredIcon" },
+  { group = "NvimTreeGitFileMergeHL", link = "NvimTreeGitMergeIcon" },
+  { group = "NvimTreeGitFileNewHL", link = "NvimTreeGitNewIcon" },
+  { group = "NvimTreeGitFileRenamedHL", link = "NvimTreeGitRenamedIcon" },
+  { group = "NvimTreeGitFileStagedHL", link = "NvimTreeGitStagedIcon" },
+
+  -- Git Folder Highlight
+  { group = "NvimTreeGitFolderDeletedHL", link = "NvimTreeGitFileDeletedHL" },
+  { group = "NvimTreeGitFolderDirtyHL", link = "NvimTreeGitFileDirtyHL" },
+  { group = "NvimTreeGitFolderIgnoredHL", link = "NvimTreeGitFileIgnoredHL" },
+  { group = "NvimTreeGitFolderMergeHL", link = "NvimTreeGitFileMergeHL" },
+  { group = "NvimTreeGitFolderNewHL", link = "NvimTreeGitFileNewHL" },
+  { group = "NvimTreeGitFolderRenamedHL", link = "NvimTreeGitFileRenamedHL" },
+  { group = "NvimTreeGitFolderStagedHL", link = "NvimTreeGitFileStagedHL" },
+
+  -- Diagnostics Icon
+  { group = "NvimTreeDiagnosticErrorIcon", link = "DiagnosticError" },
+  { group = "NvimTreeDiagnosticWarnIcon", link = "DiagnosticWarn" },
+  { group = "NvimTreeDiagnosticInfoIcon", link = "DiagnosticInfo" },
+  { group = "NvimTreeDiagnosticHintIcon", link = "DiagnosticHint" },
+
+  -- Diagnostics File Highlight
+  { group = "NvimTreeDiagnosticErrorFileHL", link = "DiagnosticUnderlineError" },
+  { group = "NvimTreeDiagnosticWarnFileHL", link = "DiagnosticUnderlineWarn" },
+  { group = "NvimTreeDiagnosticInfoFileHL", link = "DiagnosticUnderlineInfo" },
+  { group = "NvimTreeDiagnosticHintFileHL", link = "DiagnosticUnderlineHint" },
+
+  -- Diagnostics Folder Highlight
+  { group = "NvimTreeDiagnosticErrorFolderHL", link = "NvimTreeDiagnosticErrorFileHL" },
+  { group = "NvimTreeDiagnosticWarnFolderHL", link = "NvimTreeDiagnosticWarnFileHL" },
+  { group = "NvimTreeDiagnosticInfoFolderHL", link = "NvimTreeDiagnosticInfoFileHL" },
+  { group = "NvimTreeDiagnosticHintFolderHL", link = "NvimTreeDiagnosticHintFileHL" },
+}
+
+-- nvim-tree highlight groups to legacy
+M.LEGACY_LINKS = {
+  NvimTreeModifiedIcon = "NvimTreeModifiedFile",
+
+  NvimTreeOpenedHL = "NvimTreeOpenedFile",
+
+  NvimTreeBookmarkIcon = "NvimTreeBookmark",
+
+  NvimTreeGitDeletedIcon = "NvimTreeGitDeleted",
+  NvimTreeGitDirtyIcon = "NvimTreeGitDirty",
+  NvimTreeGitIgnoredIcon = "NvimTreeGitIgnored",
+  NvimTreeGitMergeIcon = "NvimTreeGitMerge",
+  NvimTreeGitNewIcon = "NvimTreeGitNew",
+  NvimTreeGitRenamedIcon = "NvimTreeGitRenamed",
+  NvimTreeGitStagedIcon = "NvimTreeGitStaged",
+
+  NvimTreeGitFileDeletedHL = "NvimTreeFileDeleted",
+  NvimTreeGitFileDirtyHL = "NvimTreeFileDirty",
+  NvimTreeGitFileIgnoredHL = "NvimTreeFileIgnored",
+  NvimTreeGitFileMergeHL = "NvimTreeFileMerge",
+  NvimTreeGitFileNewHL = "NvimTreeFileNew",
+  NvimTreeGitFileRenamedHL = "NvimTreeFileRenamed",
+  NvimTreeGitFileStagedHL = "NvimTreeFileStaged",
+
+  NvimTreeGitFolderDeletedHL = "NvimTreeFolderDeleted",
+  NvimTreeGitFolderDirtyHL = "NvimTreeFolderDirty",
+  NvimTreeGitFolderIgnoredHL = "NvimTreeFolderIgnored",
+  NvimTreeGitFolderMergeHL = "NvimTreeFolderMerge",
+  NvimTreeGitFolderNewHL = "NvimTreeFolderNew",
+  NvimTreeGitFolderRenamedHL = "NvimTreeFolderRenamed",
+  NvimTreeGitFolderStagedHL = "NvimTreeFolderStaged",
+
+  NvimTreeDiagnosticErrorIcon = "NvimTreeLspDiagnosticsError",
+  NvimTreeDiagnosticWarnIcon = "NvimTreeLspDiagnosticsWarning",
+  NvimTreeDiagnosticInfoIcon = "NvimTreeLspDiagnosticsInformation",
+  NvimTreeDiagnosticHintIcon = "NvimTreeLspDiagnosticsHint",
+
+  NvimTreeDiagnosticErrorFileHL = "NvimTreeLspDiagnosticsErrorText",
+  NvimTreeDiagnosticWarnFileHL = "NvimTreeLspDiagnosticsWarningText",
+  NvimTreeDiagnosticInfoFileHL = "NvimTreeLspDiagnosticsInformationText",
+  NvimTreeDiagnosticHintFileHL = "NvimTreeLspDiagnosticsHintText",
+
+  NvimTreeDiagnosticErrorFolderHL = "NvimTreeLspDiagnosticsErrorFolderText",
+  NvimTreeDiagnosticWarnFolderHL = "NvimTreeLspDiagnosticsWarningFolderText",
+  NvimTreeDiagnosticInfoFolderHL = "NvimTreeLspDiagnosticsInformationFolderText",
+  NvimTreeDiagnosticHintFolderHL = "NvimTreeLspDiagnosticsHintFolderText",
+}
+
+function M.setup()
+  -- non-linked
+  for _, g in ipairs(M.HIGHLIGHT_GROUPS) do
+    if g.def then
+      vim.api.nvim_command("hi def " .. g.group .. " " .. g.def)
+    end
+  end
+
+  -- hard link override when legacy only is present
+  for from, to in pairs(M.LEGACY_LINKS) do
+    local hl_from = vim.api.nvim_get_hl(0, { name = from })
+    local hl_to = vim.api.nvim_get_hl(0, { name = to })
+    if vim.tbl_isempty(hl_from) and not vim.tbl_isempty(hl_to) then
+      vim.api.nvim_command("hi link " .. from .. " " .. to)
+    end
+  end
+
+  -- default links
+  for _, g in ipairs(M.HIGHLIGHT_GROUPS) do
+    if g.link then
+      vim.api.nvim_command("hi def link " .. g.group .. " " .. g.link)
+    end
+  end
+end
+
+return M

lua/nvim-tree/buffers.lua

@@ -0,0 +1,50 @@
+local M = {}
+
+---@type table<string, boolean> record of which file is modified
+M._modified = {}
+
+---refresh M._modified
+function M.reload_modified()
+  M._modified = {}
+  local bufs = vim.fn.getbufinfo { bufmodified = 1, buflisted = 1 }
+  for _, buf in pairs(bufs) do
+    local path = buf.name
+    if path ~= "" then -- not a [No Name] buffer
+      -- mark all the parent as modified as well
+      while
+        M._modified[path] ~= true
+        -- no need to keep going if already recorded
+        -- This also prevents an infinite loop
+      do
+        M._modified[path] = true
+        path = vim.fn.fnamemodify(path, ":h")
+      end
+    end
+  end
+end
+
+---@param node table
+---@return boolean
+function M.is_modified(node)
+  return node
+    and M.config.modified.enable
+    and M._modified[node.absolute_path]
+    and (not node.nodes or M.config.modified.show_on_dirs)
+    and (not node.open or M.config.modified.show_on_open_dirs)
+end
+
+---A buffer exists for the node's absolute path
+---@param node table
+---@return boolean
+function M.is_opened(node)
+  return node and vim.fn.bufloaded(node.absolute_path) > 0
+end
+
+---@param opts table
+function M.setup(opts)
+  M.config = {
+    modified = opts.modified,
+  }
+end
+
+return M

lua/nvim-tree/colors.lua

@@ -1,130 +0,0 @@
-local M = {}
-
-local function get_color_from_hl(hl_name, fallback)
-  local id = vim.api.nvim_get_hl_id_by_name(hl_name)
-  if not id then
-    return fallback
-  end
-
-  local foreground = vim.fn.synIDattr(vim.fn.synIDtrans(id), "fg")
-  if not foreground or foreground == "" then
-    return fallback
-  end
-
-  return foreground
-end
-
-local function get_colors()
-  return {
-    red = vim.g.terminal_color_1 or get_color_from_hl("Keyword", "Red"),
-    green = vim.g.terminal_color_2 or get_color_from_hl("Character", "Green"),
-    yellow = vim.g.terminal_color_3 or get_color_from_hl("PreProc", "Yellow"),
-    blue = vim.g.terminal_color_4 or get_color_from_hl("Include", "Blue"),
-    purple = vim.g.terminal_color_5 or get_color_from_hl("Define", "Purple"),
-    cyan = vim.g.terminal_color_6 or get_color_from_hl("Conditional", "Cyan"),
-    dark_red = vim.g.terminal_color_9 or get_color_from_hl("Keyword", "DarkRed"),
-    orange = vim.g.terminal_color_11 or get_color_from_hl("Number", "Orange"),
-  }
-end
-
-local function get_hl_groups()
-  local colors = get_colors()
-
-  return {
-    IndentMarker = { fg = "#8094b4" },
-    Symlink = { gui = "bold", fg = colors.cyan },
-    FolderIcon = { fg = "#8094b4" },
-    RootFolder = { fg = colors.purple },
-
-    ExecFile = { gui = "bold", fg = colors.green },
-    SpecialFile = { gui = "bold,underline", fg = colors.yellow },
-    ImageFile = { gui = "bold", fg = colors.purple },
-    OpenedFile = { gui = "bold", fg = colors.green },
-    ModifiedFile = { fg = colors.green },
-
-    GitDirty = { fg = colors.dark_red },
-    GitDeleted = { fg = colors.dark_red },
-    GitStaged = { fg = colors.green },
-    GitMerge = { fg = colors.orange },
-    GitRenamed = { fg = colors.purple },
-    GitNew = { fg = colors.yellow },
-
-    WindowPicker = { gui = "bold", fg = "#ededed", bg = "#4493c8" },
-    LiveFilterPrefix = { gui = "bold", fg = colors.purple },
-    LiveFilterValue = { gui = "bold", fg = "#fff" },
-
-    Bookmark = { fg = colors.green },
-  }
-end
-
-local function get_links()
-  return {
-    FolderName = "Directory",
-    EmptyFolderName = "Directory",
-    OpenedFolderName = "Directory",
-    SymlinkFolderName = "Directory",
-    OpenedFolderIcon = "NvimTreeFolderIcon",
-    ClosedFolderIcon = "NvimTreeFolderIcon",
-    OpenedFileIcon = "NvimTreeOpenedFile",
-    Normal = "Normal",
-    NormalFloat = "NormalFloat",
-    NormalNC = "NvimTreeNormal",
-    EndOfBuffer = "EndOfBuffer",
-    CursorLineNr = "CursorLineNr",
-    LineNr = "LineNr",
-    CursorLine = "CursorLine",
-    WinSeparator = "WinSeparator",
-    CursorColumn = "CursorColumn",
-    FileDirty = "NvimTreeGitDirty",
-    FileNew = "NvimTreeGitNew",
-    FileRenamed = "NvimTreeGitRenamed",
-    FileMerge = "NvimTreeGitMerge",
-    FileStaged = "NvimTreeGitStaged",
-    FileDeleted = "NvimTreeGitDeleted",
-    FileIgnored = "NvimTreeGitIgnored",
-    FolderDirty = "NvimTreeFileDirty",
-    FolderNew = "NvimTreeFileNew",
-    FolderRenamed = "NvimTreeFileRenamed",
-    FolderMerge = "NvimTreeFileMerge",
-    FolderStaged = "NvimTreeFileStaged",
-    FolderDeleted = "NvimTreeFileDeleted",
-    FolderIgnored = "NvimTreeFileIgnored",
-    LspDiagnosticsError = "DiagnosticError",
-    LspDiagnosticsWarning = "DiagnosticWarn",
-    LspDiagnosticsInformation = "DiagnosticInfo",
-    LspDiagnosticsHint = "DiagnosticHint",
-    LspDiagnosticsErrorText = "NvimTreeLspDiagnosticsError",
-    LspDiagnosticsWarningText = "NvimTreeLspDiagnosticsWarning",
-    LspDiagnosticsInformationText = "NvimTreeLspDiagnosticsInformation",
-    LspDiagnosticsHintText = "NvimTreeLspDiagnosticsHintFile",
-    LspDiagnosticsErrorFolderText = "NvimTreeLspDiagnosticsErrorText",
-    LspDiagnosticsWarningFolderText = "NvimTreeLspDiagnosticsWarningText",
-    LspDiagnosticsInformationFolderText = "NvimTreeLspDiagnosticsInformationText",
-    LspDiagnosticsHintFolderText = "NvimTreeLspDiagnosticsHintFileText",
-    Popup = "Normal",
-    GitIgnored = "Comment",
-    StatusLine = "StatusLine",
-    StatusLineNC = "StatusLineNC",
-    SignColumn = "NvimTreeNormal",
-    CutHL = "SpellBad",
-    CopiedHL = "SpellRare",
-    BookmarkHL = "SpellLocal",
-  }
-end
-
-function M.setup()
-  local highlight_groups = get_hl_groups()
-  for k, d in pairs(highlight_groups) do
-    local gui = d.gui and " gui=" .. d.gui or ""
-    local fg = d.fg and " guifg=" .. d.fg or ""
-    local bg = d.bg and " guibg=" .. d.bg or ""
-    vim.api.nvim_command("hi def NvimTree" .. k .. gui .. fg .. bg)
-  end
-
-  local links = get_links()
-  for k, d in pairs(links) do
-    vim.api.nvim_command("hi def link NvimTree" .. k .. " " .. d)
-  end
-end
-
-return M

lua/nvim-tree/commands.lua

@@ -134,6 +134,13 @@ local CMDS = {
       api.tree.collapse_all(true)
     end,
   },
+  {
+    name = "NvimTreeHiTest",
+    opts = {
+      desc = "nvim-tree: highlight test",
+    },
+    command = api.diagnostics.hi_test,
+  },
 }
 
 function M.get()

lua/nvim-tree/core.lua

@@ -1,6 +1,4 @@
 local events = require "nvim-tree.events"
-local explorer = require "nvim-tree.explorer"
-local live_filter = require "nvim-tree.live-filter"
 local view = require "nvim-tree.view"
 local log = require "nvim-tree.log"
 
@@ -17,7 +15,7 @@ function M.init(foldername)
   if TreeExplorer then
     TreeExplorer:destroy()
   end
-  TreeExplorer = explorer.Explorer.new(foldername)
+  TreeExplorer = require("nvim-tree.explorer"):new(foldername)
   if not first_init_done then
     events._dispatch_ready()
     first_init_done = true
@@ -45,7 +43,7 @@ function M.get_nodes_starting_line()
   if view.is_root_folder_visible(M.get_cwd()) then
     offset = offset + 1
   end
-  if live_filter.filter then
+  if TreeExplorer and TreeExplorer.live_filter.filter then
     return offset + 1
   end
   return offset

lua/nvim-tree/diagnostics.lua

@@ -1,33 +1,58 @@
+local core = require "nvim-tree.core"
 local utils = require "nvim-tree.utils"
 local view = require "nvim-tree.view"
-local core = require "nvim-tree.core"
 local log = require "nvim-tree.log"
 
 local M = {}
 
-local severity_levels = {
+---COC severity level strings to LSP severity levels
+---@enum COC_SEVERITY_LEVELS
+local COC_SEVERITY_LEVELS = {
   Error = 1,
   Warning = 2,
   Information = 3,
   Hint = 4,
 }
 
----@return table
+---Absolute Node path to LSP severity level
+---@alias NodeSeverities table<string, lsp.DiagnosticSeverity>
+
+---@class DiagStatus
+---@field value lsp.DiagnosticSeverity|nil
+---@field cache_version integer
+
+--- The buffer-severity mappings derived during the last diagnostic list update.
+---@type NodeSeverities
+local NODE_SEVERITIES = {}
+
+---The cache version number of the buffer-severity mappings.
+---@type integer
+local NODE_SEVERITIES_VERSION = 0
+
+---@param path string
+---@return string
+local function uniformize_path(path)
+  return utils.canonical_path(path:gsub("\\", "/"))
+end
+
+---Marshal severities from LSP. Does nothing when LSP disabled.
+---@return NodeSeverities
 local function from_nvim_lsp()
   local buffer_severity = {}
 
-  local is_disabled = false
+  -- is_enabled is not present in all 0.10 builds/releases, see #2781
-  if vim.fn.has "nvim-0.9" == 1 then
+  local is_enabled = false
-    is_disabled = vim.diagnostic.is_disabled()
+  if vim.fn.has "nvim-0.10" == 1 and type(vim.diagnostic.is_enabled) == "function" then
+    is_enabled = vim.diagnostic.is_enabled()
+  elseif type(vim.diagnostic.is_disabled) == "function" then ---@diagnostic disable-line: deprecated
+    is_enabled = not vim.diagnostic.is_disabled() ---@diagnostic disable-line: deprecated
   end
 
-  if not is_disabled then
+  if is_enabled then
     for _, diagnostic in ipairs(vim.diagnostic.get(nil, { severity = M.severity })) do
-      local buf = diagnostic.bufnr
+      if diagnostic.severity and diagnostic.bufnr and vim.api.nvim_buf_is_valid(diagnostic.bufnr) then
-      if vim.api.nvim_buf_is_valid(buf) then
+        local bufname = uniformize_path(vim.api.nvim_buf_get_name(diagnostic.bufnr))
-        local bufname = vim.api.nvim_buf_get_name(buf)
+        if not buffer_severity[bufname] or diagnostic.severity < buffer_severity[bufname] then
-        local lowest_severity = buffer_severity[bufname]
-        if not lowest_severity or diagnostic.severity < lowest_severity then
           buffer_severity[bufname] = diagnostic.severity
         end
       end
@@ -37,91 +62,151 @@ local function from_nvim_lsp()
   return buffer_severity
 end
 
----@param severity integer
+---Severity is within diagnostics.severity.min, diagnostics.severity.max
+---@param severity lsp.DiagnosticSeverity
 ---@param config table
 ---@return boolean
 local function is_severity_in_range(severity, config)
   return config.max <= severity and severity <= config.min
 end
 
----@return table
+---Handle any COC exceptions, preventing any propagation
+---@param err string
+local function handle_coc_exception(err)
+  log.line("diagnostics", "handle_coc_exception: %s", vim.inspect(err))
+  local notify = true
+
+  -- avoid distractions on interrupts (CTRL-C)
+  if err:find "Vim:Interrupt" or err:find "Keyboard interrupt" then
+    notify = false
+  end
+
+  if notify then
+    require("nvim-tree.notify").error("Diagnostics update from coc.nvim failed. " .. vim.inspect(err))
+  end
+end
+
+---COC service initialized
+---@return boolean
+local function is_using_coc()
+  return vim.g.coc_service_initialized == 1
+end
+
+---Marshal severities from COC. Does nothing when COC service not started.
+---@return NodeSeverities
 local function from_coc()
-  if vim.g.coc_service_initialized ~= 1 then
+  if not is_using_coc() then
     return {}
   end
 
-  local diagnostic_list = vim.fn.CocAction "diagnosticList"
+  local ok, diagnostic_list = xpcall(function()
-  if type(diagnostic_list) ~= "table" or vim.tbl_isempty(diagnostic_list) then
+    return vim.fn.CocAction "diagnosticList"
+  end, handle_coc_exception)
+  if not ok or type(diagnostic_list) ~= "table" or vim.tbl_isempty(diagnostic_list) then
     return {}
   end
 
-  local diagnostics = {}
-  for _, diagnostic in ipairs(diagnostic_list) do
-    local bufname = diagnostic.file
-    local coc_severity = severity_levels[diagnostic.severity]
-
-    local serverity = diagnostics[bufname] or vim.diagnostic.severity.HINT
-    diagnostics[bufname] = math.min(coc_severity, serverity)
-  end
-
   local buffer_severity = {}
-  for bufname, severity in pairs(diagnostics) do
+  for _, diagnostic in ipairs(diagnostic_list) do
-    if is_severity_in_range(severity, M.severity) then
+    local bufname = uniformize_path(diagnostic.file)
-      buffer_severity[bufname] = severity
+    local coc_severity = COC_SEVERITY_LEVELS[diagnostic.severity]
+    local highest_severity = buffer_severity[bufname] or coc_severity
+    if is_severity_in_range(highest_severity, M.severity) then
+      buffer_severity[bufname] = math.min(highest_severity, coc_severity)
     end
   end
 
   return buffer_severity
 end
 
-local function is_using_coc()
+---Maybe retrieve severity level from the cache
-  return vim.g.coc_service_initialized == 1
+---@param node Node
+---@return DiagStatus
+local function from_cache(node)
+  local nodepath = uniformize_path(node.absolute_path)
+  local max_severity = nil
+  if not node.nodes then
+    -- direct cache hit for files
+    max_severity = NODE_SEVERITIES[nodepath]
+  else
+    -- dirs should be searched in the list of cached buffer names by prefix
+    for bufname, severity in pairs(NODE_SEVERITIES) do
+      local node_contains_buf = vim.startswith(bufname, nodepath .. "/")
+      if node_contains_buf then
+        if severity == M.severity.max then
+          max_severity = severity
+          break
+        else
+          max_severity = math.min(max_severity or severity, severity)
+        end
+      end
+    end
+  end
+  return { value = max_severity, cache_version = NODE_SEVERITIES_VERSION }
 end
 
+---Fired on DiagnosticChanged and CocDiagnosticChanged events:
+---debounced retrieval, cache update, version increment and draw
 function M.update()
-  if not M.enable or not core.get_explorer() or not view.is_buf_valid(view.get_bufnr()) then
+  if not M.enable then
     return
   end
   utils.debounce("diagnostics", M.debounce_delay, function()
     local profile = log.profile_start "diagnostics update"
-    log.line("diagnostics", "update")
-
-    local buffer_severity
     if is_using_coc() then
-      buffer_severity = from_coc()
+      NODE_SEVERITIES = from_coc()
     else
-      buffer_severity = from_nvim_lsp()
+      NODE_SEVERITIES = from_nvim_lsp()
     end
-
+    NODE_SEVERITIES_VERSION = NODE_SEVERITIES_VERSION + 1
-    local nodes_by_line = utils.get_nodes_by_line(core.get_explorer().nodes, core.get_nodes_starting_line())
+    if log.enabled "diagnostics" then
-    for _, node in pairs(nodes_by_line) do
+      for bufname, severity in pairs(NODE_SEVERITIES) do
-      node.diag_status = nil
+        log.line("diagnostics", "Indexing bufname '%s' with severity %d", bufname, severity)
-    end
-
-    for bufname, severity in pairs(buffer_severity) do
-      local bufpath = utils.canonical_path(bufname)
-      log.line("diagnostics", " bufpath '%s' severity %d", bufpath, severity)
-      if 0 < severity and severity < 5 then
-        for line, node in pairs(nodes_by_line) do
-          local nodepath = utils.canonical_path(node.absolute_path)
-          log.line("diagnostics", "  %d checking nodepath '%s'", line, nodepath)
-
-          local node_contains_buf = vim.startswith(bufpath:gsub("\\", "/"), nodepath:gsub("\\", "/") .. "/")
-          if M.show_on_dirs and node_contains_buf and (not node.open or M.show_on_open_dirs) then
-            log.line("diagnostics", " matched fold node '%s'", node.absolute_path)
-            node.diag_status = severity
-          elseif nodepath == bufpath then
-            log.line("diagnostics", " matched file node '%s'", node.absolute_path)
-            node.diag_status = severity
-          end
-        end
       end
     end
     log.profile_end(profile)
-    require("nvim-tree.renderer").draw()
+    if view.is_buf_valid(view.get_bufnr()) then
+      local explorer = core.get_explorer()
+      if explorer then
+        explorer.renderer:draw()
+      end
+    end
   end)
 end
 
+---Maybe retrieve diagnostic status for a node.
+---Returns cached value when node's version matches.
+---@param node Node
+---@return DiagStatus|nil
+function M.get_diag_status(node)
+  if not M.enable then
+    return nil
+  end
+
+  -- dir but we shouldn't show on dirs at all
+  if node.nodes ~= nil and not M.show_on_dirs then
+    return nil
+  end
+
+  -- here, we do a lazy update of the diagnostic status carried by the node.
+  -- This is by design, as diagnostics and nodes live in completely separate
+  -- worlds, and this module is the link between the two
+  if not node.diag_status or node.diag_status.cache_version < NODE_SEVERITIES_VERSION then
+    node.diag_status = from_cache(node)
+  end
+
+  -- file
+  if not node.nodes then
+    return node.diag_status
+  end
+
+  -- dir is closed or we should show on open_dirs
+  if not node.open or M.show_on_open_dirs then
+    return node.diag_status
+  end
+  return nil
+end
+
 function M.setup(opts)
   M.enable = opts.diagnostics.enable
   M.debounce_delay = opts.diagnostics.debounce_delay

lua/nvim-tree/enum.lua

@@ -12,9 +12,22 @@ M.HL_POSITION = {
 ---Setup options for "*_placement"
 ---@enum ICON_PLACEMENT
 M.ICON_PLACEMENT = {
-  signcolumn = 0,
+  none = 0,
-  before = 1,
+  signcolumn = 1,
-  after = 2,
+  before = 2,
+  after = 3,
+  right_align = 4,
+}
+
+---Reason for filter in filter.lua
+---@enum FILTER_REASON
+M.FILTER_REASON = {
+  none = 0, -- It's not filtered
+  git = 1,
+  buf = 2,
+  dotfile = 4,
+  custom = 8,
+  bookmark = 16,
 }
 
 return M

lua/nvim-tree/explorer/explore.lua

@@ -2,68 +2,87 @@ local utils = require "nvim-tree.utils"
 local builders = require "nvim-tree.explorer.node-builders"
 local explorer_node = require "nvim-tree.explorer.node"
 local git = require "nvim-tree.git"
-local sorters = require "nvim-tree.explorer.sorters"
-local filters = require "nvim-tree.explorer.filters"
-local live_filter = require "nvim-tree.live-filter"
 local log = require "nvim-tree.log"
 
+local FILTER_REASON = require("nvim-tree.enum").FILTER_REASON
 local Watcher = require "nvim-tree.watcher"
 
 local M = {}
 
----@param type_ string|nil
----@param cwd string
----@return any
-local function get_type_from(type_, cwd)
-  return type_ or (vim.loop.fs_stat(cwd) or {}).type
-end
-
 ---@param handle uv.uv_fs_t
 ---@param cwd string
 ---@param node Node
 ---@param git_status table
-local function populate_children(handle, cwd, node, git_status)
+---@param parent Explorer
+local function populate_children(handle, cwd, node, git_status, parent)
   local node_ignored = explorer_node.is_git_ignored(node)
   local nodes_by_path = utils.bool_record(node.nodes, "absolute_path")
-  local filter_status = filters.prepare(git_status)
+
+  local filter_status = parent.filters:prepare(git_status)
+
+  node.hidden_stats = vim.tbl_deep_extend("force", node.hidden_stats or {}, {
+    git = 0,
+    buf = 0,
+    dotfile = 0,
+    custom = 0,
+    bookmark = 0,
+  })
+
   while true do
-    local name, t = vim.loop.fs_scandir_next(handle)
+    local name, _ = vim.loop.fs_scandir_next(handle)
     if not name then
       break
     end
 
     local abs = utils.path_join { cwd, name }
 
-    local profile = log.profile_start("explore populate_children %s", abs)
+    if Watcher.is_fs_event_capable(abs) then
+      local profile = log.profile_start("explore populate_children %s", abs)
 
-    t = get_type_from(t, abs)
+      ---@type uv.fs_stat.result|nil
-    if not filters.should_filter(abs, filter_status) and not nodes_by_path[abs] and Watcher.is_fs_event_capable(abs) then
+      local stat = vim.loop.fs_stat(abs)
-      local child = nil
+
-      if t == "directory" and vim.loop.fs_access(abs, "R") then
+      -- Type must come from fs_stat and not fs_scandir_next to maintain sshfs compatibility
-        child = builders.folder(node, abs, name)
+      local type = stat and stat.type or nil
-      elseif t == "file" then
+
-        child = builders.file(node, abs, name)
+      local filter_reason = parent.filters:should_filter_as_reason(abs, stat, filter_status)
-      elseif t == "link" then
+      if filter_reason == FILTER_REASON.none then
-        local link = builders.link(node, abs, name)
+        if not nodes_by_path[abs] then
-        if link.link_to ~= nil then
+          local child = nil
-          child = link
+          if type == "directory" and vim.loop.fs_access(abs, "R") then
+            child = builders.folder(node, abs, name, stat)
+          elseif type == "file" then
+            child = builders.file(node, abs, name, stat)
+          elseif type == "link" then
+            local link = builders.link(node, abs, name, stat)
+            if link.link_to ~= nil then
+              child = link
+            end
+          end
+          if child then
+            table.insert(node.nodes, child)
+            nodes_by_path[child.absolute_path] = true
+            explorer_node.update_git_status(child, node_ignored, git_status)
+          end
+        end
+      else
+        for reason, value in pairs(FILTER_REASON) do
+          if filter_reason == value then
+            node.hidden_stats[reason] = node.hidden_stats[reason] + 1
+          end
         end
       end
-      if child then
-        table.insert(node.nodes, child)
-        nodes_by_path[child.absolute_path] = true
-        explorer_node.update_git_status(child, node_ignored, git_status)
-      end
-    end
 
-    log.profile_end(profile)
+      log.profile_end(profile)
+    end
   end
 end
 
 ---@param node Node
 ---@param status table
+---@param parent Explorer
 ---@return Node[]|nil
-function M.explore(node, status)
+function M.explore(node, status, parent)
   local cwd = node.link_to or node.absolute_path
   local handle = vim.loop.fs_scandir(cwd)
   if not handle then
@@ -72,7 +91,7 @@ function M.explore(node, status)
 
   local profile = log.profile_start("explore init %s", node.absolute_path)
 
-  populate_children(handle, cwd, node, status)
+  populate_children(handle, cwd, node, status, parent)
 
   local is_root = not node.parent
   local child_folder_only = explorer_node.has_one_child_folder(node) and node.nodes[1]
@@ -80,15 +99,15 @@ function M.explore(node, status)
     local child_cwd = child_folder_only.link_to or child_folder_only.absolute_path
     local child_status = git.load_project_status(child_cwd)
     node.group_next = child_folder_only
-    local ns = M.explore(child_folder_only, child_status)
+    local ns = M.explore(child_folder_only, child_status, parent)
     node.nodes = ns or {}
 
     log.profile_end(profile)
     return ns
   end
 
-  sorters.sort(node.nodes)
+  parent.sorters:sort(node.nodes)
-  live_filter.apply_filter(node)
+  parent.live_filter:apply_filter(node)
 
   log.profile_end(profile)
   return node.nodes

lua/nvim-tree/explorer/filters.lua

@@ -1,14 +1,53 @@
 local utils = require "nvim-tree.utils"
+local FILTER_REASON = require("nvim-tree.enum").FILTER_REASON
 
-local M = {
+---@class Filters to handle all opts.filters and related API
-  ignore_list = {},
+---@field config table hydrated user opts.filters
-  exclude_list = {},
+---@field private explorer Explorer
-}
+---@field private exclude_list string[] filters.exclude
+---@field private ignore_list string[] filters.custom string table
+---@field private custom_function (fun(absolute_path: string): boolean)|nil filters.custom function
+local Filters = {}
+
+---@param opts table user options
+---@param explorer Explorer
+---@return Filters
+function Filters:new(opts, explorer)
+  local o = {
+    explorer = explorer,
+    ignore_list = {},
+    exclude_list = opts.filters.exclude,
+    custom_function = nil,
+    config = {
+      enable = opts.filters.enable,
+      filter_custom = true,
+      filter_dotfiles = opts.filters.dotfiles,
+      filter_git_ignored = opts.filters.git_ignored,
+      filter_git_clean = opts.filters.git_clean,
+      filter_no_buffer = opts.filters.no_buffer,
+      filter_no_bookmark = opts.filters.no_bookmark,
+    },
+  }
+
+  local custom_filter = opts.filters.custom
+  if type(custom_filter) == "function" then
+    o.custom_function = custom_filter
+  else
+    if custom_filter and #custom_filter > 0 then
+      for _, filter_name in pairs(custom_filter) do
+        o.ignore_list[filter_name] = true
+      end
+    end
+  end
+  setmetatable(o, self)
+  self.__index = self
+  return o
+end
 
 ---@param path string
 ---@return boolean
-local function is_excluded(path)
+local function is_excluded(self, path)
-  for _, node in ipairs(M.exclude_list) do
+  for _, node in ipairs(self.exclude_list) do
     if path:match(node) then
       return true
     end
@@ -20,7 +59,7 @@ end
 ---@param path string Absolute path
 ---@param git_status table from prepare
 ---@return boolean
-local function git(path, git_status)
+local function git(self, path, git_status)
   if type(git_status) ~= "table" or type(git_status.files) ~= "table" or type(git_status.dirs) ~= "table" then
     return false
   end
@@ -31,12 +70,12 @@ local function git(path, git_status)
   status = status or git_status.dirs.indirect[path] and git_status.dirs.indirect[path][1]
 
   -- filter ignored; overrides clean as they are effectively dirty
-  if M.config.filter_git_ignored and status == "!!" then
+  if self.config.filter_git_ignored and status == "!!" then
     return true
   end
 
   -- filter clean
-  if M.config.filter_git_clean and not status then
+  if self.config.filter_git_clean and not status then
     return true
   end
 
@@ -46,16 +85,15 @@ end
 ---Check if the given path has no listed buffer
 ---@param path string Absolute path
 ---@param bufinfo table vim.fn.getbufinfo { buflisted = 1 }
----@param unloaded_bufnr number optional bufnr recently unloaded via BufUnload event
 ---@return boolean
-local function buf(path, bufinfo, unloaded_bufnr)
+local function buf(self, path, bufinfo)
-  if not M.config.filter_no_buffer or type(bufinfo) ~= "table" then
+  if not self.config.filter_no_buffer or type(bufinfo) ~= "table" then
     return false
   end
 
   -- filter files with no open buffer and directories containing no open buffers
   for _, b in ipairs(bufinfo) do
-    if b.name == path or b.name:find(path .. "/", 1, true) and b.bufnr ~= unloaded_bufnr then
+    if b.name == path or b.name:find(path .. "/", 1, true) then
       return false
     end
   end
@@ -65,22 +103,63 @@ end
 
 ---@param path string
 ---@return boolean
-local function dotfile(path)
+local function dotfile(self, path)
-  return M.config.filter_dotfiles and utils.path_basename(path):sub(1, 1) == "."
+  return self.config.filter_dotfiles and utils.path_basename(path):sub(1, 1) == "."
+end
+
+---@param path string
+---@param path_type string|nil filetype of path
+---@param bookmarks table<string, string|nil> path, filetype table of bookmarked files
+local function bookmark(self, path, path_type, bookmarks)
+  if not self.config.filter_no_bookmark then
+    return false
+  end
+  -- if bookmark is empty, we should see a empty filetree
+  if next(bookmarks) == nil then
+    return true
+  end
+
+  local mark_parent = utils.path_add_trailing(path)
+  for mark, mark_type in pairs(bookmarks) do
+    if path == mark then
+      return false
+    end
+
+    if path_type == "directory" then
+      -- check if path is mark's parent
+      if vim.fn.stridx(mark, mark_parent) == 0 then
+        return false
+      end
+    end
+    if mark_type == "directory" then
+      -- check if mark is path's parent
+      local path_parent = utils.path_add_trailing(mark)
+      if vim.fn.stridx(path, path_parent) == 0 then
+        return false
+      end
+    end
+  end
+
+  return true
 end
 
 ---@param path string
 ---@return boolean
-local function custom(path)
+local function custom(self, path)
-  if not M.config.filter_custom then
+  if not self.config.filter_custom then
     return false
   end
 
   local basename = utils.path_basename(path)
 
+  -- filter user's custom function
+  if self.custom_function and self.custom_function(path) then
+    return true
+  end
+
   -- filter custom regexes
   local relpath = utils.path_relative(path, vim.loop.cwd())
-  for pat, _ in pairs(M.ignore_list) do
+  for pat, _ in pairs(self.ignore_list) do
     if vim.fn.match(relpath, pat) ~= -1 or vim.fn.match(basename, pat) ~= -1 then
       return true
     end
@@ -88,7 +167,7 @@ local function custom(path)
 
   local idx = path:match ".+()%.[^.]+$"
   if idx then
-    if M.ignore_list["*" .. string.sub(path, idx)] == true then
+    if self.ignore_list["*" .. string.sub(path, idx)] == true then
       return true
     end
   end
@@ -98,56 +177,80 @@ end
 
 ---Prepare arguments for should_filter. This is done prior to should_filter for efficiency reasons.
 ---@param git_status table|nil optional results of git.load_project_status(...)
----@param unloaded_bufnr number|nil optional bufnr recently unloaded via BufUnload event
 ---@return table
 --- git_status: reference
---- unloaded_bufnr: copy
 --- bufinfo: empty unless no_buffer set: vim.fn.getbufinfo { buflisted = 1 }
-function M.prepare(git_status, unloaded_bufnr)
+--- bookmarks: absolute paths to boolean
+function Filters:prepare(git_status)
   local status = {
     git_status = git_status or {},
-    unloaded_bufnr = unloaded_bufnr,
     bufinfo = {},
+    bookmarks = {},
   }
 
-  if M.config.filter_no_buffer then
+  if self.config.filter_no_buffer then
     status.bufinfo = vim.fn.getbufinfo { buflisted = 1 }
   end
 
+  local explorer = require("nvim-tree.core").get_explorer()
+  if explorer then
+    for _, node in pairs(explorer.marks:list()) do
+      status.bookmarks[node.absolute_path] = node.type
+    end
+  end
+
   return status
 end
 
 ---Check if the given path should be filtered.
 ---@param path string Absolute path
+---@param fs_stat uv.fs_stat.result|nil fs_stat of file
 ---@param status table from prepare
 ---@return boolean
-function M.should_filter(path, status)
+function Filters:should_filter(path, fs_stat, status)
-  -- exclusions override all filters
+  if not self.config.enable then
-  if is_excluded(path) then
     return false
   end
 
-  return git(path, status.git_status) or buf(path, status.bufinfo, status.unloaded_bufnr) or dotfile(path) or custom(path)
+  -- exclusions override all filters
+  if is_excluded(self, path) then
+    return false
+  end
+
+  return git(self, path, status.git_status)
+    or buf(self, path, status.bufinfo)
+    or dotfile(self, path)
+    or custom(self, path)
+    or bookmark(self, path, fs_stat and fs_stat.type, status.bookmarks)
 end
 
-function M.setup(opts)
+--- Check if the given path should be filtered, and provide the reason why it was
-  M.config = {
+---@param path string Absolute path
-    filter_custom = true,
+---@param fs_stat uv.fs_stat.result|nil fs_stat of file
-    filter_dotfiles = opts.filters.dotfiles,
+---@param status table from prepare
-    filter_git_ignored = opts.filters.git_ignored,
+---@return FILTER_REASON
-    filter_git_clean = opts.filters.git_clean,
+function Filters:should_filter_as_reason(path, fs_stat, status)
-    filter_no_buffer = opts.filters.no_buffer,
+  if not self.config.enable then
-  }
+    return FILTER_REASON.none
+  end
 
-  M.ignore_list = {}
+  if is_excluded(self, path) then
-  M.exclude_list = opts.filters.exclude
+    return FILTER_REASON.none
+  end
 
-  local custom_filter = opts.filters.custom
+  if git(self, path, status.git_status) then
-  if custom_filter and #custom_filter > 0 then
+    return FILTER_REASON.git
-    for _, filter_name in pairs(custom_filter) do
+  elseif buf(self, path, status.bufinfo) then
-      M.ignore_list[filter_name] = true
+    return FILTER_REASON.buf
-    end
+  elseif dotfile(self, path) then
+    return FILTER_REASON.dotfile
+  elseif custom(self, path) then
+    return FILTER_REASON.custom
+  elseif bookmark(self, path, fs_stat and fs_stat.type, status.bookmarks) then
+    return FILTER_REASON.bookmark
+  else
+    return FILTER_REASON.none
   end
 end
 
-return M
+return Filters

lua/nvim-tree/explorer/init.lua

@@ -1,42 +1,77 @@
+local builders = require "nvim-tree.explorer.node-builders"
 local git = require "nvim-tree.git"
+local log = require "nvim-tree.log"
+local notify = require "nvim-tree.notify"
+local utils = require "nvim-tree.utils"
+local view = require "nvim-tree.view"
 local watch = require "nvim-tree.explorer.watch"
 local explorer_node = require "nvim-tree.explorer.node"
 
-local M = {}
+local Iterator = require "nvim-tree.iterators.node-iterator"
+local NodeIterator = require "nvim-tree.iterators.node-iterator"
+local Watcher = require "nvim-tree.watcher"
 
-M.explore = require("nvim-tree.explorer.explore").explore
+local Filters = require "nvim-tree.explorer.filters"
-M.reload = require("nvim-tree.explorer.reload").reload
+local Marks = require "nvim-tree.marks"
+local LiveFilter = require "nvim-tree.explorer.live-filter"
+local Sorters = require "nvim-tree.explorer.sorters"
+local Clipboard = require "nvim-tree.actions.fs.clipboard"
+local Renderer = require "nvim-tree.renderer"
+
+local FILTER_REASON = require("nvim-tree.enum").FILTER_REASON
+
+local config
 
 ---@class Explorer
+---@field opts table user options
 ---@field absolute_path string
 ---@field nodes Node[]
 ---@field open boolean
-
+---@field watcher Watcher|nil
+---@field renderer Renderer
+---@field filters Filters
+---@field live_filter LiveFilter
+---@field sorters Sorter
+---@field marks Marks
+---@field clipboard Clipboard
 local Explorer = {}
-Explorer.__index = Explorer
 
----@param cwd string|nil
+---@param path string|nil
----@return Explorer
+---@return Explorer|nil
-function Explorer.new(cwd)
+function Explorer:new(path)
-  cwd = vim.loop.fs_realpath(cwd or vim.loop.cwd())
+  local err
 
-  ---@class Explorer
+  if path then
-  local explorer = setmetatable({
+    path, err = vim.loop.fs_realpath(path)
-    absolute_path = cwd,
+  else
+    path, err = vim.loop.cwd()
+  end
+  if not path then
+    notify.error(err)
+    return
+  end
+
+  local o = {
+    opts = config,
+    absolute_path = path,
     nodes = {},
     open = true,
-  }, Explorer)
+    sorters = Sorters:new(config),
-  explorer.watcher = watch.create_watcher(explorer)
+  }
-  explorer:_load(explorer)
-  return explorer
-end
 
----@private
+  setmetatable(o, self)
----@param node Node
+  self.__index = self
-function Explorer:_load(node)
+
-  local cwd = node.link_to or node.absolute_path
+  o.watcher = watch.create_watcher(o)
-  local git_status = git.load_project_status(cwd)
+  o.renderer = Renderer:new(config, o)
-  M.explore(node, git_status)
+  o.filters = Filters:new(config, o)
+  o.live_filter = LiveFilter:new(config, o)
+  o.marks = Marks:new(config, o)
+  o.clipboard = Clipboard:new(config, o)
+
+  o:_load(o)
+
+  return o
 end
 
 ---@param node Node
@@ -56,15 +91,395 @@ function Explorer:destroy()
   iterate(self)
 end
 
-function M.setup(opts)
+---@param node Node
+---@param git_status table|nil
+function Explorer:reload(node, git_status)
+  local cwd = node.link_to or node.absolute_path
+  local handle = vim.loop.fs_scandir(cwd)
+  if not handle then
+    return
+  end
+
+  local profile = log.profile_start("reload %s", node.absolute_path)
+
+  local filter_status = self.filters:prepare(git_status)
+
+  if node.group_next then
+    node.nodes = { node.group_next }
+    node.group_next = nil
+  end
+
+  local remain_childs = {}
+
+  local node_ignored = explorer_node.is_git_ignored(node)
+  ---@type table<string, Node>
+  local nodes_by_path = utils.key_by(node.nodes, "absolute_path")
+
+  -- To reset we must 'zero' everything that we use
+  node.hidden_stats = vim.tbl_deep_extend("force", node.hidden_stats or {}, {
+    git = 0,
+    buf = 0,
+    dotfile = 0,
+    custom = 0,
+    bookmark = 0,
+  })
+
+  while true do
+    local name, _ = vim.loop.fs_scandir_next(handle)
+    if not name then
+      break
+    end
+
+    local abs = utils.path_join { cwd, name }
+    ---@type uv.fs_stat.result|nil
+    local stat = vim.loop.fs_stat(abs)
+
+    local filter_reason = self.filters:should_filter_as_reason(abs, stat, filter_status)
+    if filter_reason == FILTER_REASON.none then
+      remain_childs[abs] = true
+
+      -- Type must come from fs_stat and not fs_scandir_next to maintain sshfs compatibility
+      local type = stat and stat.type or nil
+
+      -- Recreate node if type changes.
+      if nodes_by_path[abs] then
+        local n = nodes_by_path[abs]
+
+        if n.type ~= type then
+          utils.array_remove(node.nodes, n)
+          explorer_node.node_destroy(n)
+          nodes_by_path[abs] = nil
+        end
+      end
+
+      if not nodes_by_path[abs] then
+        local new_child = nil
+        if type == "directory" and vim.loop.fs_access(abs, "R") and Watcher.is_fs_event_capable(abs) then
+          new_child = builders.folder(node, abs, name, stat)
+        elseif type == "file" then
+          new_child = builders.file(node, abs, name, stat)
+        elseif type == "link" then
+          local link = builders.link(node, abs, name, stat)
+          if link.link_to ~= nil then
+            new_child = link
+          end
+        end
+        if new_child then
+          table.insert(node.nodes, new_child)
+          nodes_by_path[abs] = new_child
+        end
+      else
+        local n = nodes_by_path[abs]
+        if n then
+          n.executable = builders.is_executable(abs) or false
+          n.fs_stat = stat
+        end
+      end
+    else
+      for reason, value in pairs(FILTER_REASON) do
+        if filter_reason == value then
+          node.hidden_stats[reason] = node.hidden_stats[reason] + 1
+        end
+      end
+    end
+  end
+
+  node.nodes = vim.tbl_map(
+    self:update_status(nodes_by_path, node_ignored, git_status),
+    vim.tbl_filter(function(n)
+      if remain_childs[n.absolute_path] then
+        return remain_childs[n.absolute_path]
+      else
+        explorer_node.node_destroy(n)
+        return false
+      end
+    end, node.nodes)
+  )
+
+  local is_root = not node.parent
+  local child_folder_only = explorer_node.has_one_child_folder(node) and node.nodes[1]
+  if config.group_empty and not is_root and child_folder_only then
+    node.group_next = child_folder_only
+    local ns = self:reload(child_folder_only, git_status)
+    node.nodes = ns or {}
+    log.profile_end(profile)
+    return ns
+  end
+
+  self.sorters:sort(node.nodes)
+  self.live_filter:apply_filter(node)
+  log.profile_end(profile)
+  return node.nodes
+end
+
+---TODO #2837 #2871 move this and similar to node
+---Refresh contents and git status for a single node
+---@param node Node
+---@param callback function
+function Explorer:refresh_node(node, callback)
+  if type(node) ~= "table" then
+    callback()
+  end
+
+  local parent_node = utils.get_parent_of_group(node)
+
+  self:reload_and_get_git_project(node.absolute_path, function(toplevel, project)
+    self:reload(parent_node, project)
+
+    self:update_parent_statuses(parent_node, project, toplevel)
+
+    callback()
+  end)
+end
+
+---Refresh contents of all nodes to a path: actual directory and links.
+---Groups will be expanded if needed.
+---@param path string absolute path
+function Explorer:refresh_parent_nodes_for_path(path)
+  local profile = log.profile_start("refresh_parent_nodes_for_path %s", path)
+
+  -- collect parent nodes from the top down
+  local parent_nodes = {}
+  NodeIterator.builder({ self })
+    :recursor(function(node)
+      return node.nodes
+    end)
+    :applier(function(node)
+      local abs_contains = node.absolute_path and path:find(node.absolute_path, 1, true) == 1
+      local link_contains = node.link_to and path:find(node.link_to, 1, true) == 1
+      if abs_contains or link_contains then
+        table.insert(parent_nodes, node)
+      end
+    end)
+    :iterate()
+
+  -- refresh in order; this will expand groups as needed
+  for _, node in ipairs(parent_nodes) do
+    local toplevel = git.get_toplevel(node.absolute_path)
+    local project = git.get_project(toplevel) or {}
+
+    self:reload(node, project)
+    self:update_parent_statuses(node, project, toplevel)
+  end
+
+  log.profile_end(profile)
+end
+
+---@private
+---@param node Node
+function Explorer:_load(node)
+  local cwd = node.link_to or node.absolute_path
+  local git_status = git.load_project_status(cwd)
+  self:explore(node, git_status, self)
+end
+
+---@private
+---@param nodes_by_path table
+---@param node_ignored boolean
+---@param status table|nil
+---@return fun(node: Node): table
+function Explorer:update_status(nodes_by_path, node_ignored, status)
+  return function(node)
+    if nodes_by_path[node.absolute_path] then
+      explorer_node.update_git_status(node, node_ignored, status)
+    end
+    return node
+  end
+end
+
+---TODO #2837 #2871 move this and similar to node
+---@private
+---@param path string
+---@param callback fun(toplevel: string|nil, project: table|nil)
+function Explorer:reload_and_get_git_project(path, callback)
+  local toplevel = git.get_toplevel(path)
+
+  git.reload_project(toplevel, path, function()
+    callback(toplevel, git.get_project(toplevel) or {})
+  end)
+end
+
+---TODO #2837 #2871 move this and similar to node
+---@private
+---@param node Node
+---@param project table|nil
+---@param root string|nil
+function Explorer:update_parent_statuses(node, project, root)
+  while project and node do
+    -- step up to the containing project
+    if node.absolute_path == root then
+      -- stop at the top of the tree
+      if not node.parent then
+        break
+      end
+
+      root = git.get_toplevel(node.parent.absolute_path)
+
+      -- stop when no more projects
+      if not root then
+        break
+      end
+
+      -- update the containing project
+      project = git.get_project(root)
+      git.reload_project(root, node.absolute_path, nil)
+    end
+
+    -- update status
+    explorer_node.update_git_status(node, explorer_node.is_git_ignored(node.parent), project)
+
+    -- maybe parent
+    node = node.parent
+  end
+end
+
+---@private
+---@param handle uv.uv_fs_t
+---@param cwd string
+---@param node Node
+---@param git_status table
+---@param parent Explorer
+function Explorer:populate_children(handle, cwd, node, git_status, parent)
+  local node_ignored = explorer_node.is_git_ignored(node)
+  local nodes_by_path = utils.bool_record(node.nodes, "absolute_path")
+
+  local filter_status = parent.filters:prepare(git_status)
+
+  node.hidden_stats = vim.tbl_deep_extend("force", node.hidden_stats or {}, {
+    git = 0,
+    buf = 0,
+    dotfile = 0,
+    custom = 0,
+    bookmark = 0,
+  })
+
+  while true do
+    local name, t = vim.loop.fs_scandir_next(handle)
+    if not name then
+      break
+    end
+
+    local abs = utils.path_join { cwd, name }
+
+    if Watcher.is_fs_event_capable(abs) then
+      local profile = log.profile_start("populate_children %s", abs)
+
+      ---@type uv.fs_stat.result|nil
+      local stat = vim.loop.fs_stat(abs)
+      local filter_reason = parent.filters:should_filter_as_reason(abs, stat, filter_status)
+      if filter_reason == FILTER_REASON.none and not nodes_by_path[abs] then
+        local child = nil
+        if t == "directory" and vim.loop.fs_access(abs, "R") then
+          child = builders.folder(node, abs, name, stat)
+        elseif t == "file" then
+          child = builders.file(node, abs, name, stat)
+        elseif t == "link" then
+          local link = builders.link(node, abs, name, stat)
+          if link.link_to ~= nil then
+            child = link
+          end
+        end
+        if child then
+          table.insert(node.nodes, child)
+          nodes_by_path[child.absolute_path] = true
+          explorer_node.update_git_status(child, node_ignored, git_status)
+        end
+      else
+        for reason, value in pairs(FILTER_REASON) do
+          if filter_reason == value then
+            node.hidden_stats[reason] = node.hidden_stats[reason] + 1
+          end
+        end
+      end
+
+      log.profile_end(profile)
+    end
+  end
+end
+
+---@private
+---@param node Node
+---@param status table
+---@param parent Explorer
+---@return Node[]|nil
+function Explorer:explore(node, status, parent)
+  local cwd = node.link_to or node.absolute_path
+  local handle = vim.loop.fs_scandir(cwd)
+  if not handle then
+    return
+  end
+
+  local profile = log.profile_start("explore %s", node.absolute_path)
+
+  self:populate_children(handle, cwd, node, status, parent)
+
+  local is_root = not node.parent
+  local child_folder_only = explorer_node.has_one_child_folder(node) and node.nodes[1]
+  if config.renderer.group_empty and not is_root and child_folder_only then
+    local child_cwd = child_folder_only.link_to or child_folder_only.absolute_path
+    local child_status = git.load_project_status(child_cwd)
+    node.group_next = child_folder_only
+    local ns = self:explore(child_folder_only, child_status, parent)
+    node.nodes = ns or {}
+
+    log.profile_end(profile)
+    return ns
+  end
+
+  parent.sorters:sort(node.nodes)
+  parent.live_filter:apply_filter(node)
+
+  log.profile_end(profile)
+  return node.nodes
+end
+
+---@private
+---@param projects table
+function Explorer:refresh_nodes(projects)
+  Iterator.builder({ self })
+    :applier(function(n)
+      if n.nodes then
+        local toplevel = git.get_toplevel(n.cwd or n.link_to or n.absolute_path)
+        self:reload(n, projects[toplevel] or {})
+      end
+    end)
+    :recursor(function(n)
+      return n.group_next and { n.group_next } or (n.open and n.nodes)
+    end)
+    :iterate()
+end
+
+local event_running = false
+function Explorer:reload_explorer()
+  if event_running or vim.v.exiting ~= vim.NIL then
+    return
+  end
+  event_running = true
+
+  local projects = git.reload()
+  self:refresh_nodes(projects)
+  if view.is_visible() then
+    self.renderer:draw()
+  end
+  event_running = false
+end
+
+function Explorer:reload_git()
+  if not git.config.git.enable or event_running then
+    return
+  end
+  event_running = true
+
+  local projects = git.reload()
+  explorer_node.reload_node_status(self, projects)
+  self.renderer:draw()
+  event_running = false
+end
+
+function Explorer.setup(opts)
+  config = opts
   require("nvim-tree.explorer.node").setup(opts)
-  require("nvim-tree.explorer.explore").setup(opts)
-  require("nvim-tree.explorer.filters").setup(opts)
-  require("nvim-tree.explorer.sorters").setup(opts)
-  require("nvim-tree.explorer.reload").setup(opts)
   require("nvim-tree.explorer.watch").setup(opts)
 end
 
-M.Explorer = Explorer
+return Explorer
-
-return M

lua/nvim-tree/explorer/live-filter.lua

@@ -2,34 +2,54 @@ local view = require "nvim-tree.view"
 local utils = require "nvim-tree.utils"
 local Iterator = require "nvim-tree.iterators.node-iterator"
 
-local M = {
+---@class LiveFilter
-  filter = nil,
+---@field explorer Explorer
-}
+---@field prefix string
+---@field always_show_folders boolean
+---@field filter string
+local LiveFilter = {}
 
-local function redraw()
+---@param opts table
-  require("nvim-tree.renderer").draw()
+---@param explorer Explorer
+function LiveFilter:new(opts, explorer)
+  local o = {
+    explorer = explorer,
+    prefix = opts.live_filter.prefix,
+    always_show_folders = opts.live_filter.always_show_folders,
+    filter = nil,
+  }
+  setmetatable(o, self)
+  self.__index = self
+  return o
 end
 
 ---@param node_ Node|nil
-local function reset_filter(node_)
+local function reset_filter(self, node_)
-  node_ = node_ or require("nvim-tree.core").get_explorer()
+  node_ = node_ or self.explorer
 
   if node_ == nil then
     return
   end
 
+  node_.hidden_stats = vim.tbl_deep_extend("force", node_.hidden_stats or {}, {
+    live_filter = 0,
+  })
+
   Iterator.builder(node_.nodes)
     :hidden()
     :applier(function(node)
       node.hidden = false
+      node.hidden_stats = vim.tbl_deep_extend("force", node.hidden_stats or {}, {
+        live_filter = 0,
+      })
     end)
     :iterate()
 end
 
-local overlay_bufnr = nil
+local overlay_bufnr = 0
-local overlay_winnr = nil
+local overlay_winnr = 0
 
-local function remove_overlay()
+local function remove_overlay(self)
   if view.View.float.enable and view.View.float.quit_on_focus_loss then
     -- return to normal nvim-tree float behaviour when filter window is closed
     vim.api.nvim_create_autocmd("WinLeave", {
@@ -45,26 +65,30 @@ local function remove_overlay()
 
   vim.api.nvim_win_close(overlay_winnr, true)
   vim.api.nvim_buf_delete(overlay_bufnr, { force = true })
-  overlay_bufnr = nil
+  overlay_bufnr = 0
-  overlay_winnr = nil
+  overlay_winnr = 0
 
-  if M.filter == "" then
+  if self.filter == "" then
-    M.clear_filter()
+    self:clear_filter()
   end
 end
 
 ---@param node Node
 ---@return boolean
-local function matches(node)
+local function matches(self, node)
+  if not self.explorer.filters.config.enable then
+    return true
+  end
+
   local path = node.absolute_path
   local name = vim.fn.fnamemodify(path, ":t")
-  return vim.regex(M.filter):match_str(name) ~= nil
+  return vim.regex(self.filter):match_str(name) ~= nil
 end
 
 ---@param node_ Node|nil
-function M.apply_filter(node_)
+function LiveFilter:apply_filter(node_)
-  if not M.filter or M.filter == "" then
+  if not self.filter or self.filter == "" then
-    reset_filter(node_)
+    reset_filter(self, node_)
     return
   end
 
@@ -74,6 +98,10 @@ function M.apply_filter(node_)
     local filtered_nodes = 0
     local nodes = node.group_next and { node.group_next } or node.nodes
 
+    node.hidden_stats = vim.tbl_deep_extend("force", node.hidden_stats or {}, {
+      live_filter = 0,
+    })
+
     if nodes then
       for _, n in pairs(nodes) do
         iterate(n)
@@ -83,31 +111,37 @@ function M.apply_filter(node_)
       end
     end
 
-    local has_nodes = nodes and (M.always_show_folders or #nodes > filtered_nodes)
+    node.hidden_stats.live_filter = filtered_nodes
-    local ok, is_match = pcall(matches, node)
+
+    local has_nodes = nodes and (self.always_show_folders or #nodes > filtered_nodes)
+    local ok, is_match = pcall(matches, self, node)
     node.hidden = not (has_nodes or (ok and is_match))
   end
 
-  iterate(node_ or require("nvim-tree.core").get_explorer())
+  iterate(node_ or self.explorer)
 end
 
-local function record_char()
+local function record_char(self)
   vim.schedule(function()
-    M.filter = vim.api.nvim_buf_get_lines(overlay_bufnr, 0, -1, false)[1]
+    self.filter = vim.api.nvim_buf_get_lines(overlay_bufnr, 0, -1, false)[1]
-    M.apply_filter()
+    self:apply_filter()
-    redraw()
+    self.explorer.renderer:draw()
   end)
 end
 
-local function configure_buffer_overlay()
+local function configure_buffer_overlay(self)
   overlay_bufnr = vim.api.nvim_create_buf(false, true)
 
   vim.api.nvim_buf_attach(overlay_bufnr, true, {
-    on_lines = record_char,
+    on_lines = function()
+      return record_char(self)
+    end,
   })
 
   vim.api.nvim_create_autocmd("InsertLeave", {
-    callback = remove_overlay,
+    callback = function()
+      return remove_overlay(self)
+    end,
     once = true,
   })
 
@@ -115,17 +149,17 @@ local function configure_buffer_overlay()
 end
 
 ---@return integer
-local function calculate_overlay_win_width()
+local function calculate_overlay_win_width(self)
   local wininfo = vim.fn.getwininfo(view.get_winnr())[1]
 
   if wininfo then
-    return wininfo.width - wininfo.textoff - #M.prefix
+    return wininfo.width - wininfo.textoff - #self.prefix
   end
 
   return 20
 end
 
-local function create_overlay()
+local function create_overlay(self)
   if view.View.float.enable then
     -- don't close nvim-tree float when focus is changed to filter window
     vim.api.nvim_clear_autocmds {
@@ -135,41 +169,49 @@ local function create_overlay()
     }
   end
 
-  configure_buffer_overlay()
+  configure_buffer_overlay(self)
   overlay_winnr = vim.api.nvim_open_win(overlay_bufnr, true, {
     col = 1,
     row = 0,
     relative = "cursor",
-    width = calculate_overlay_win_width(),
+    width = calculate_overlay_win_width(self),
     height = 1,
     border = "none",
     style = "minimal",
   })
-  vim.api.nvim_buf_set_option(overlay_bufnr, "modifiable", true)
+
-  vim.api.nvim_buf_set_lines(overlay_bufnr, 0, -1, false, { M.filter })
+  if vim.fn.has "nvim-0.10" == 1 then
+    vim.api.nvim_set_option_value("modifiable", true, { buf = overlay_bufnr })
+  else
+    vim.api.nvim_buf_set_option(overlay_bufnr, "modifiable", true) ---@diagnostic disable-line: deprecated
+  end
+
+  vim.api.nvim_buf_set_lines(overlay_bufnr, 0, -1, false, { self.filter })
   vim.cmd "startinsert"
-  vim.api.nvim_win_set_cursor(overlay_winnr, { 1, #M.filter + 1 })
+  vim.api.nvim_win_set_cursor(overlay_winnr, { 1, #self.filter + 1 })
 end
 
-function M.start_filtering()
+function LiveFilter:start_filtering()
   view.View.live_filter.prev_focused_node = require("nvim-tree.lib").get_node_at_cursor()
-  M.filter = M.filter or ""
+  self.filter = self.filter or ""
 
-  redraw()
+  self.explorer.renderer:draw()
   local row = require("nvim-tree.core").get_nodes_starting_line() - 1
-  local col = #M.prefix > 0 and #M.prefix - 1 or 1
+  local col = #self.prefix > 0 and #self.prefix - 1 or 1
   view.set_cursor { row, col }
   -- needs scheduling to let the cursor move before initializing the window
-  vim.schedule(create_overlay)
+  vim.schedule(function()
+    return create_overlay(self)
+  end)
 end
 
-function M.clear_filter()
+function LiveFilter:clear_filter()
   local node = require("nvim-tree.lib").get_node_at_cursor()
   local last_node = view.View.live_filter.prev_focused_node
 
-  M.filter = nil
+  self.filter = nil
-  reset_filter()
+  reset_filter(self)
-  redraw()
+  self.explorer.renderer:draw()
 
   if node then
     utils.focus_file(node.absolute_path)
@@ -178,9 +220,4 @@ function M.clear_filter()
   end
 end
 
-function M.setup(opts)
+return LiveFilter
-  M.prefix = opts.live_filter.prefix
-  M.always_show_folders = opts.live_filter.always_show_folders
-end
-
-return M

lua/nvim-tree/explorer/node-builders.lua

@@ -6,15 +6,16 @@ local M = {}
 ---@param parent Node
 ---@param absolute_path string
 ---@param name string
+---@param fs_stat uv.fs_stat.result|nil
 ---@return Node
-function M.folder(parent, absolute_path, name)
+function M.folder(parent, absolute_path, name, fs_stat)
   local handle = vim.loop.fs_scandir(absolute_path)
   local has_children = handle and vim.loop.fs_scandir_next(handle) ~= nil
 
   local node = {
     type = "directory",
     absolute_path = absolute_path,
-    fs_stat = vim.loop.fs_stat(absolute_path),
+    fs_stat = fs_stat,
     group_next = nil, -- If node is grouped, this points to the next child dir/link node
     has_children = has_children,
     name = name,
@@ -43,8 +44,9 @@ end
 ---@param parent Node
 ---@param absolute_path string
 ---@param name string
+---@param fs_stat uv.fs_stat.result|nil
 ---@return Node
-function M.file(parent, absolute_path, name)
+function M.file(parent, absolute_path, name, fs_stat)
   local ext = string.match(name, ".?[^.]+%.(.*)") or ""
 
   return {
@@ -52,7 +54,7 @@ function M.file(parent, absolute_path, name)
     absolute_path = absolute_path,
     executable = M.is_executable(absolute_path),
     extension = ext,
-    fs_stat = vim.loop.fs_stat(absolute_path),
+    fs_stat = fs_stat,
     name = name,
     parent = parent,
   }
@@ -66,15 +68,16 @@ end
 ---@param parent Node
 ---@param absolute_path string
 ---@param name string
+---@param fs_stat uv.fs_stat.result|nil
 ---@return Node
-function M.link(parent, absolute_path, name)
+function M.link(parent, absolute_path, name, fs_stat)
   --- I dont know if this is needed, because in my understanding, there isn't hard links in windows, but just to be sure i changed it.
   local link_to = vim.loop.fs_realpath(absolute_path)
   local open, nodes, has_children
 
   local is_dir_link = (link_to ~= nil) and vim.loop.fs_stat(link_to).type == "directory"
 
-  if is_dir_link then
+  if is_dir_link and link_to then
     local handle = vim.loop.fs_scandir(link_to)
     has_children = handle and vim.loop.fs_scandir_next(handle) ~= nil
     open = false
@@ -84,7 +87,7 @@ function M.link(parent, absolute_path, name)
   local node = {
     type = "link",
     absolute_path = absolute_path,
-    fs_stat = vim.loop.fs_stat(absolute_path),
+    fs_stat = fs_stat,
     group_next = nil, -- If node is grouped, this points to the next child dir/link node
     has_children = has_children,
     link_to = link_to,

lua/nvim-tree/explorer/node.lua

@@ -1,3 +1,5 @@
+local git = {} -- circular dependencies
+
 local M = {}
 
 ---@class GitStatus
@@ -29,7 +31,7 @@ end
 ---@param absolute_path string
 ---@return GitStatus
 local function get_git_status(parent_ignored, status, absolute_path)
-  local file_status = parent_ignored and "!!" or status.files and status.files[absolute_path]
+  local file_status = parent_ignored and "!!" or (status and status.files and status.files[absolute_path])
   return { file = file_status }
 end
 
@@ -122,12 +124,42 @@ function M.get_git_status(node)
   end
 end
 
+---@param parent_node Node|nil
+---@param projects table
+function M.reload_node_status(parent_node, projects)
+  if parent_node == nil then
+    return
+  end
+
+  local toplevel = git.get_toplevel(parent_node.absolute_path)
+  local status = projects[toplevel] or {}
+  for _, node in ipairs(parent_node.nodes) do
+    M.update_git_status(node, M.is_git_ignored(parent_node), status)
+    if node.nodes and #node.nodes > 0 then
+      M.reload_node_status(node, projects)
+    end
+  end
+end
+
 ---@param node Node
 ---@return boolean
 function M.is_git_ignored(node)
   return node and node.git_status ~= nil and node.git_status.file == "!!"
 end
 
+---@param node Node
+---@return boolean
+function M.is_dotfile(node)
+  if node == nil then
+    return false
+  end
+  if node.is_dot or (node.name and (node.name:sub(1, 1) == ".")) or M.is_dotfile(node.parent) then
+    node.is_dot = true
+    return true
+  end
+  return false
+end
+
 ---@param node Node
 function M.node_destroy(node)
   if not node then
@@ -144,6 +176,8 @@ function M.setup(opts)
   M.config = {
     git = opts.git,
   }
+
+  git = require "nvim-tree.git"
 end
 
 return M

lua/nvim-tree/explorer/reload.lua

@@ -1,240 +0,0 @@
-local utils = require "nvim-tree.utils"
-local builders = require "nvim-tree.explorer.node-builders"
-local explorer_node = require "nvim-tree.explorer.node"
-local filters = require "nvim-tree.explorer.filters"
-local sorters = require "nvim-tree.explorer.sorters"
-local live_filter = require "nvim-tree.live-filter"
-local git = require "nvim-tree.git"
-local log = require "nvim-tree.log"
-
-local NodeIterator = require "nvim-tree.iterators.node-iterator"
-local Watcher = require "nvim-tree.watcher"
-
-local M = {}
-
----@param nodes_by_path table
----@param node_ignored boolean
----@param status table
----@return fun(node: Node): table
-local function update_status(nodes_by_path, node_ignored, status)
-  return function(node)
-    if nodes_by_path[node.absolute_path] then
-      explorer_node.update_git_status(node, node_ignored, status)
-    end
-    return node
-  end
-end
-
----@param path string
----@param callback fun(toplevel: string|nil, project: table|nil)
-local function reload_and_get_git_project(path, callback)
-  local toplevel = git.get_toplevel(path)
-
-  git.reload_project(toplevel, path, function()
-    callback(toplevel, git.get_project(toplevel) or {})
-  end)
-end
-
----@param node Node
----@param project table|nil
----@param root string|nil
-local function update_parent_statuses(node, project, root)
-  while project and node do
-    -- step up to the containing project
-    if node.absolute_path == root then
-      -- stop at the top of the tree
-      if not node.parent then
-        break
-      end
-
-      root = git.get_toplevel(node.parent.absolute_path)
-
-      -- stop when no more projects
-      if not root then
-        break
-      end
-
-      -- update the containing project
-      project = git.get_project(root)
-      git.reload_project(root, node.absolute_path, nil)
-    end
-
-    -- update status
-    explorer_node.update_git_status(node, explorer_node.is_git_ignored(node.parent), project)
-
-    -- maybe parent
-    node = node.parent
-  end
-end
-
----@param node Node
----@param git_status table
----@param unloaded_bufnr number|nil
-function M.reload(node, git_status, unloaded_bufnr)
-  local cwd = node.link_to or node.absolute_path
-  local handle = vim.loop.fs_scandir(cwd)
-  if not handle then
-    return
-  end
-
-  local profile = log.profile_start("reload %s", node.absolute_path)
-
-  local filter_status = filters.prepare(git_status, unloaded_bufnr)
-
-  if node.group_next then
-    node.nodes = { node.group_next }
-    node.group_next = nil
-  end
-
-  local child_names = {}
-
-  local node_ignored = explorer_node.is_git_ignored(node)
-  local nodes_by_path = utils.key_by(node.nodes, "absolute_path")
-  while true do
-    local name, t = vim.loop.fs_scandir_next(handle, cwd)
-    if not name then
-      break
-    end
-
-    local stat
-    local function fs_stat_cached(path)
-      if stat ~= nil then
-        return stat
-      end
-
-      stat = vim.loop.fs_stat(path)
-      return stat
-    end
-
-    local abs = utils.path_join { cwd, name }
-    t = t or (fs_stat_cached(abs) or {}).type
-    if not filters.should_filter(abs, filter_status) then
-      child_names[abs] = true
-
-      -- Recreate node if type changes.
-      if nodes_by_path[abs] then
-        local n = nodes_by_path[abs]
-
-        if n.type ~= t then
-          utils.array_remove(node.nodes, n)
-          explorer_node.node_destroy(n)
-          nodes_by_path[abs] = nil
-        end
-      end
-
-      if not nodes_by_path[abs] then
-        if t == "directory" and vim.loop.fs_access(abs, "R") and Watcher.is_fs_event_capable(abs) then
-          local folder = builders.folder(node, abs, name)
-          nodes_by_path[abs] = folder
-          table.insert(node.nodes, folder)
-        elseif t == "file" then
-          local file = builders.file(node, abs, name)
-          nodes_by_path[abs] = file
-          table.insert(node.nodes, file)
-        elseif t == "link" then
-          local link = builders.link(node, abs, name)
-          if link.link_to ~= nil then
-            nodes_by_path[abs] = link
-            table.insert(node.nodes, link)
-          end
-        end
-      else
-        local n = nodes_by_path[abs]
-        if n then
-          n.executable = builders.is_executable(abs)
-          n.fs_stat = fs_stat_cached(abs)
-        end
-      end
-    end
-  end
-
-  node.nodes = vim.tbl_map(
-    update_status(nodes_by_path, node_ignored, git_status),
-    vim.tbl_filter(function(n)
-      if child_names[n.absolute_path] then
-        return child_names[n.absolute_path]
-      else
-        explorer_node.node_destroy(n)
-        return false
-      end
-    end, node.nodes)
-  )
-
-  local is_root = not node.parent
-  local child_folder_only = explorer_node.has_one_child_folder(node) and node.nodes[1]
-  if M.config.group_empty and not is_root and child_folder_only then
-    node.group_next = child_folder_only
-    local ns = M.reload(child_folder_only, git_status)
-    node.nodes = ns or {}
-    log.profile_end(profile)
-    return ns
-  end
-
-  sorters.sort(node.nodes)
-  live_filter.apply_filter(node)
-  log.profile_end(profile)
-  return node.nodes
-end
-
----Refresh contents and git status for a single node
----@param node Node
----@param callback function
-function M.refresh_node(node, callback)
-  if type(node) ~= "table" then
-    callback()
-  end
-
-  local parent_node = utils.get_parent_of_group(node)
-
-  reload_and_get_git_project(node.absolute_path, function(toplevel, project)
-    require("nvim-tree.explorer.reload").reload(parent_node, project)
-
-    update_parent_statuses(parent_node, project, toplevel)
-
-    callback()
-  end)
-end
-
----Refresh contents of all nodes to a path: actual directory and links.
----Groups will be expanded if needed.
----@param path string absolute path
-function M.refresh_parent_nodes_for_path(path)
-  local explorer = require("nvim-tree.core").get_explorer()
-  if not explorer then
-    return
-  end
-
-  local profile = log.profile_start("refresh_parent_nodes_for_path %s", path)
-
-  -- collect parent nodes from the top down
-  local parent_nodes = {}
-  NodeIterator.builder({ explorer })
-    :recursor(function(node)
-      return node.nodes
-    end)
-    :applier(function(node)
-      local abs_contains = node.absolute_path and path:find(node.absolute_path, 1, true) == 1
-      local link_contains = node.link_to and path:find(node.link_to, 1, true) == 1
-      if abs_contains or link_contains then
-        table.insert(parent_nodes, node)
-      end
-    end)
-    :iterate()
-
-  -- refresh in order; this will expand groups as needed
-  for _, node in ipairs(parent_nodes) do
-    local toplevel = git.get_toplevel(node.absolute_path)
-    local project = git.get_project(toplevel) or {}
-
-    M.reload(node, project)
-    update_parent_statuses(node, project, toplevel)
-  end
-
-  log.profile_end(profile)
-end
-
-function M.setup(opts)
-  M.config = opts.renderer
-end
-
-return M

lua/nvim-tree/explorer/sorters.lua

@@ -1,12 +1,27 @@
-local M = {}
-
 local C = {}
 
+---@class Sorter
+local Sorter = {}
+
+function Sorter:new(opts)
+  local o = {}
+  setmetatable(o, self)
+  self.__index = self
+  o.config = vim.deepcopy(opts.sort)
+
+  if type(o.config.sorter) == "function" then
+    o.user = o.config.sorter
+  end
+  return o
+end
+
 --- Predefined comparator, defaulting to name
 ---@param sorter string as per options
 ---@return function
-local function get_comparator(sorter)
+function Sorter:get_comparator(sorter)
-  return C[sorter] or C.name
+  return function(a, b)
+    return (C[sorter] or C.name)(a, b, self.config)
+  end
 end
 
 ---Create a shallow copy of a portion of a list.
@@ -27,17 +42,17 @@ end
 ---@param a Node
 ---@param b Node
 ---@return boolean|nil
-local function folders_or_files_first(a, b)
+local function folders_or_files_first(a, b, cfg)
-  if not (M.config.sort.folders_first or M.config.sort.files_first) then
+  if not (cfg.folders_first or cfg.files_first) then
     return
   end
 
   if not a.nodes and b.nodes then
     -- file <> folder
-    return M.config.sort.files_first
+    return cfg.files_first
   elseif a.nodes and not b.nodes then
     -- folder <> file
-    return not M.config.sort.files_first
+    return not cfg.files_first
   end
 end
 
@@ -97,8 +112,8 @@ end
 
 ---Perform a merge sort using sorter option.
 ---@param t table nodes
-function M.sort(t)
+function Sorter:sort(t)
-  if C.user then
+  if self.user then
     local t_user = {}
     local origin_index = {}
 
@@ -115,9 +130,9 @@ function M.sort(t)
       table.insert(origin_index, n)
     end
 
-    local predefined = C.user(t_user)
+    local predefined = self.user(t_user)
     if predefined then
-      split_merge(t, 1, #t, get_comparator(predefined))
+      split_merge(t, 1, #t, self:get_comparator(predefined))
       return
     end
 
@@ -142,7 +157,7 @@ function M.sort(t)
 
     split_merge(t, 1, #t, mini_comparator) -- sort by user order
   else
-    split_merge(t, 1, #t, get_comparator(M.config.sort.sorter))
+    split_merge(t, 1, #t, self:get_comparator(self.config.sorter))
   end
 end
 
@@ -150,12 +165,12 @@ end
 ---@param b Node
 ---@param ignorecase boolean|nil
 ---@return boolean
-local function node_comparator_name_ignorecase_or_not(a, b, ignorecase)
+local function node_comparator_name_ignorecase_or_not(a, b, ignorecase, cfg)
   if not (a and b) then
     return true
   end
 
-  local early_return = folders_or_files_first(a, b)
+  local early_return = folders_or_files_first(a, b, cfg)
   if early_return ~= nil then
     return early_return
   end
@@ -167,20 +182,20 @@ local function node_comparator_name_ignorecase_or_not(a, b, ignorecase)
   end
 end
 
-function C.case_sensitive(a, b)
+function C.case_sensitive(a, b, cfg)
-  return node_comparator_name_ignorecase_or_not(a, b, false)
+  return node_comparator_name_ignorecase_or_not(a, b, false, cfg)
 end
 
-function C.name(a, b)
+function C.name(a, b, cfg)
-  return node_comparator_name_ignorecase_or_not(a, b, true)
+  return node_comparator_name_ignorecase_or_not(a, b, true, cfg)
 end
 
-function C.modification_time(a, b)
+function C.modification_time(a, b, cfg)
   if not (a and b) then
     return true
   end
 
-  local early_return = folders_or_files_first(a, b)
+  local early_return = folders_or_files_first(a, b, cfg)
   if early_return ~= nil then
     return early_return
   end
@@ -199,17 +214,17 @@ function C.modification_time(a, b)
   return last_modified_b <= last_modified_a
 end
 
-function C.suffix(a, b)
+function C.suffix(a, b, cfg)
   if not (a and b) then
     return true
   end
 
   -- directories go first
-  local early_return = folders_or_files_first(a, b)
+  local early_return = folders_or_files_first(a, b, cfg)
   if early_return ~= nil then
     return early_return
   elseif a.nodes and b.nodes then
-    return C.name(a, b)
+    return C.name(a, b, cfg)
   end
 
   -- dotfiles go second
@@ -218,7 +233,7 @@ function C.suffix(a, b)
   elseif a.name:sub(1, 1) ~= "." and b.name:sub(1, 1) == "." then
     return false
   elseif a.name:sub(1, 1) == "." and b.name:sub(1, 1) == "." then
-    return C.name(a, b)
+    return C.name(a, b, cfg)
   end
 
   -- unsuffixed go third
@@ -230,7 +245,7 @@ function C.suffix(a, b)
   elseif a_suffix_ndx and not b_suffix_ndx then
     return false
   elseif not (a_suffix_ndx and b_suffix_ndx) then
-    return C.name(a, b)
+    return C.name(a, b, cfg)
   end
 
   -- finally, compare by suffixes
@@ -242,18 +257,18 @@ function C.suffix(a, b)
   elseif not a_suffix and b_suffix then
     return false
   elseif a_suffix:lower() == b_suffix:lower() then
-    return C.name(a, b)
+    return C.name(a, b, cfg)
   end
 
   return a_suffix:lower() < b_suffix:lower()
 end
 
-function C.extension(a, b)
+function C.extension(a, b, cfg)
   if not (a and b) then
     return true
   end
 
-  local early_return = folders_or_files_first(a, b)
+  local early_return = folders_or_files_first(a, b, cfg)
   if early_return ~= nil then
     return early_return
   end
@@ -267,18 +282,18 @@ function C.extension(a, b)
   local a_ext = (a.extension or ""):lower()
   local b_ext = (b.extension or ""):lower()
   if a_ext == b_ext then
-    return C.name(a, b)
+    return C.name(a, b, cfg)
   end
 
   return a_ext < b_ext
 end
 
-function C.filetype(a, b)
+function C.filetype(a, b, cfg)
   local a_ft = vim.filetype.match { filename = a.name }
   local b_ft = vim.filetype.match { filename = b.name }
 
   -- directories first
-  local early_return = folders_or_files_first(a, b)
+  local early_return = folders_or_files_first(a, b, cfg)
   if early_return ~= nil then
     return early_return
   end
@@ -292,19 +307,10 @@ function C.filetype(a, b)
 
   -- same filetype or both nil, sort by name
   if a_ft == b_ft then
-    return C.name(a, b)
+    return C.name(a, b, cfg)
   end
 
   return a_ft < b_ft
 end
 
-function M.setup(opts)
+return Sorter
-  M.config = {}
-  M.config.sort = opts.sort
-
-  if type(M.config.sort.sorter) == "function" then
-    C.user = M.config.sort.sorter
-  end
-end
-
-return M

lua/nvim-tree/explorer/watch.lua

@@ -40,10 +40,14 @@ local function is_folder_ignored(path)
     end
   end
 
-  for _, ignore_dir in ipairs(M.config.filesystem_watchers.ignore_dirs) do
+  if type(M.config.filesystem_watchers.ignore_dirs) == "table" then
-    if vim.fn.match(path, ignore_dir) ~= -1 then
+    for _, ignore_dir in ipairs(M.config.filesystem_watchers.ignore_dirs) do
-      return true
+      if vim.fn.match(path, ignore_dir) ~= -1 then
+        return true
+      end
     end
+  elseif type(M.config.filesystem_watchers.ignore_dirs) == "function" then
+    return M.config.filesystem_watchers.ignore_dirs(path)
   end
 
   return false
@@ -72,9 +76,12 @@ function M.create_watcher(node)
       else
         log.line("watcher", "node event executing refresh '%s'", node.absolute_path)
       end
-      require("nvim-tree.explorer.reload").refresh_node(node, function()
+      local explorer = require("nvim-tree.core").get_explorer()
-        require("nvim-tree.renderer").draw()
+      if explorer then
-      end)
+        explorer:refresh_node(node, function()
+          explorer.renderer:draw()
+        end)
+      end
     end)
   end
 

lua/nvim-tree/git/init.lua

@@ -136,6 +136,10 @@ end
 ---@param path string absolute
 ---@return string|nil
 function M.get_toplevel(path)
+  if not path then
+    return nil
+  end
+
   if not M.config.git.enable then
     return nil
   end
@@ -166,12 +170,18 @@ function M.get_toplevel(path)
   if not toplevel or not git_dir then
     return nil
   end
+  local toplevel_norm = vim.fn.fnamemodify(toplevel, ":p")
 
   -- ignore disabled paths
-  for _, disabled_for_dir in ipairs(M.config.git.disable_for_dirs) do
+  if type(M.config.git.disable_for_dirs) == "table" then
-    local toplevel_norm = vim.fn.fnamemodify(toplevel, ":p")
+    for _, disabled_for_dir in ipairs(M.config.git.disable_for_dirs) do
-    local disabled_norm = vim.fn.fnamemodify(disabled_for_dir, ":p")
+      local disabled_norm = vim.fn.fnamemodify(disabled_for_dir, ":p")
-    if toplevel_norm == disabled_norm then
+      if toplevel_norm == disabled_norm then
+        return nil
+      end
+    end
+  elseif type(M.config.git.disable_for_dirs) == "function" then
+    if M.config.git.disable_for_dirs(toplevel_norm) then
       return nil
     end
   end
@@ -206,7 +216,10 @@ local function reload_tree_at(toplevel)
       end)
       :iterate()
 
-    require("nvim-tree.renderer").draw()
+    local explorer = require("nvim-tree.core").get_explorer()
+    if explorer then
+      explorer.renderer:draw()
+    end
   end)
 end
 

lua/nvim-tree/git/runner.lua

@@ -2,11 +2,6 @@ local log = require "nvim-tree.log"
 local utils = require "nvim-tree.utils"
 local notify = require "nvim-tree.notify"
 
--- TODO add "${3rd}/luv/library" to "workspace.library"
----@class uv.uv_handle_t: table
----@class uv.uv_stream_t: uv.uv_handle_t
----@class uv.uv_pipe_t: uv.uv_stream_t
-
 ---@class Runner
 local Runner = {}
 Runner.__index = Runner

lua/nvim-tree/help.lua

@@ -1,4 +1,5 @@
 local keymap = require "nvim-tree.keymap"
+local api = {} -- circular dependency
 
 local PAT_MOUSE = "^<.*Mouse"
 local PAT_CTRL = "^<C%-"
@@ -79,18 +80,19 @@ local function sort_lhs(a, b)
 end
 
 --- Compute all lines for the buffer
+---@param map table keymap.get_keymap
 ---@return table strings of text
 ---@return table arrays of arguments 3-6 for nvim_buf_add_highlight()
 ---@return number maximum length of text
-local function compute()
+local function compute(map)
   local head_lhs = "nvim-tree mappings"
   local head_rhs1 = "exit: q"
   local head_rhs2 = string.format("sort by %s: s", M.config.sort_by == "key" and "description" or "keymap")
 
   -- formatted lhs and desc from active keymap
-  local mappings = vim.tbl_map(function(map)
+  local mappings = vim.tbl_map(function(m)
-    return { lhs = tidy_lhs(map.lhs), desc = tidy_desc(map.desc) }
+    return { lhs = tidy_lhs(m.lhs), desc = tidy_desc(m.desc) }
-  end, keymap.get_keymap())
+  end, map)
 
   -- sorter function for mappings
   local sort_fn
@@ -119,14 +121,20 @@ local function compute()
   -- increase desc if lines are shorter than the header
   max_desc = math.max(max_desc, #head_lhs + #head_rhs1 - max_lhs)
 
-  -- header, not padded
+  -- header text, not padded
-  local hl = { { "NvimTreeRootFolder", 0, 0, #head_lhs } }
   local lines = {
     head_lhs .. string.rep(" ", max_desc + max_lhs - #head_lhs - #head_rhs1 + 2) .. head_rhs1,
     string.rep(" ", max_desc + max_lhs - #head_rhs2 + 2) .. head_rhs2,
   }
   local width = #lines[1]
 
+  -- header highlight, assume one character keys
+  local hl = {
+    { "NvimTreeFolderName", 0, 0, #head_lhs },
+    { "NvimTreeFolderName", 0, width - 1, width },
+    { "NvimTreeFolderName", 1, width - 1, width },
+  }
+
   -- mappings, left padded 1
   local fmt = string.format(" %%-%ds %%-%ds", max_lhs, max_desc)
   for i, l in ipairs(mappings) do
@@ -159,15 +167,23 @@ local function open()
   -- close existing, shouldn't be necessary
   close()
 
+  -- fetch all mappings
+  local map = keymap.get_keymap()
+
   -- text and highlight
-  local lines, hl, width = compute()
+  local lines, hl, width = compute(map)
 
   -- create the buffer
   M.bufnr = vim.api.nvim_create_buf(false, true)
 
   -- populate it
   vim.api.nvim_buf_set_lines(M.bufnr, 0, -1, false, lines)
-  vim.api.nvim_buf_set_option(M.bufnr, "modifiable", false)
+
+  if vim.fn.has "nvim-0.10" == 1 then
+    vim.api.nvim_set_option_value("modifiable", false, { buf = M.bufnr })
+  else
+    vim.api.nvim_buf_set_option(M.bufnr, "modifiable", false) ---@diagnostic disable-line: deprecated
+  end
 
   -- highlight it
   for _, h in ipairs(hl) do
@@ -195,12 +211,21 @@ local function open()
     open()
   end
 
-  local keymaps = {
+  -- hardcoded
+  local help_keymaps = {
     q = { fn = close, desc = "nvim-tree: exit help" },
+    ["<Esc>"] = { fn = close, desc = "nvim-tree: exit help" }, -- hidden
     s = { fn = toggle_sort, desc = "nvim-tree: toggle sorting method" },
   }
 
-  for k, v in pairs(keymaps) do
+  -- api help binding closes
+  for _, m in ipairs(map) do
+    if m.callback == api.tree.toggle_help then
+      help_keymaps[m.lhs] = { fn = close, desc = "nvim-tree: exit help" }
+    end
+  end
+
+  for k, v in pairs(help_keymaps) do
     vim.keymap.set("n", k, v.fn, {
       desc = v.desc,
       buffer = M.bufnr,
@@ -229,6 +254,8 @@ end
 function M.setup(opts)
   M.config.cursorline = opts.view.cursorline
   M.config.sort_by = opts.help.sort_by
+
+  api = require "nvim-tree.api"
 end
 
 return M

lua/nvim-tree/keymap.lua

@@ -64,14 +64,17 @@ function M.default_on_attach(bufnr)
   vim.keymap.set('n', 'e',       api.fs.rename_basename,              opts('Rename: Basename'))
   vim.keymap.set('n', ']e',      api.node.navigate.diagnostics.next,  opts('Next Diagnostic'))
   vim.keymap.set('n', '[e',      api.node.navigate.diagnostics.prev,  opts('Prev Diagnostic'))
-  vim.keymap.set('n', 'F',       api.live_filter.clear,               opts('Clean Filter'))
+  vim.keymap.set('n', 'F',       api.live_filter.clear,               opts('Live Filter: Clear'))
-  vim.keymap.set('n', 'f',       api.live_filter.start,               opts('Filter'))
+  vim.keymap.set('n', 'f',       api.live_filter.start,               opts('Live Filter: Start'))
   vim.keymap.set('n', 'g?',      api.tree.toggle_help,                opts('Help'))
   vim.keymap.set('n', 'gy',      api.fs.copy.absolute_path,           opts('Copy Absolute Path'))
+  vim.keymap.set('n', 'ge',      api.fs.copy.basename,                opts('Copy Basename'))
   vim.keymap.set('n', 'H',       api.tree.toggle_hidden_filter,       opts('Toggle Filter: Dotfiles'))
   vim.keymap.set('n', 'I',       api.tree.toggle_gitignore_filter,    opts('Toggle Filter: Git Ignore'))
   vim.keymap.set('n', 'J',       api.node.navigate.sibling.last,      opts('Last Sibling'))
   vim.keymap.set('n', 'K',       api.node.navigate.sibling.first,     opts('First Sibling'))
+  vim.keymap.set('n', 'L',       api.node.open.toggle_group_empty,    opts('Toggle Group Empty'))
+  vim.keymap.set('n', 'M',       api.tree.toggle_no_bookmark_filter,  opts('Toggle Filter: No Bookmark'))
   vim.keymap.set('n', 'm',       api.marks.toggle,                    opts('Toggle Bookmark'))
   vim.keymap.set('n', 'o',       api.node.open.edit,                  opts('Open'))
   vim.keymap.set('n', 'O',       api.node.open.no_window_picker,      opts('Open: No Window Picker'))

lua/nvim-tree/legacy.lua

@@ -3,6 +3,7 @@ local notify = require "nvim-tree.notify"
 
 local M = {}
 
+-- silently move, please add to help nvim-tree-legacy-opts
 local function refactored(opts)
   -- 2022/06/20
   utils.move_missing_val(opts, "update_focused_file", "update_cwd", opts, "update_focused_file", "update_root", true)
@@ -41,6 +42,24 @@ local function refactored(opts)
 
   -- 2023/08/26
   utils.move_missing_val(opts, "renderer.icons", "webdev_colors", opts, "renderer.icons.web_devicons.file", "color", true)
+
+  -- 2023/10/08
+  if type(opts.renderer) == "table" and type(opts.renderer.highlight_diagnostics) == "boolean" then
+    opts.renderer.highlight_diagnostics = opts.renderer.highlight_diagnostics and "name" or "none"
+  end
+
+  -- 2023/10/21
+  if type(opts.renderer) == "table" and type(opts.renderer.highlight_git) == "boolean" then
+    opts.renderer.highlight_git = opts.renderer.highlight_git and "name" or "none"
+  end
+
+  -- 2024/02/15
+  if type(opts.update_focused_file) == "table" then
+    if type(opts.update_focused_file.update_root) ~= "table" then
+      opts.update_focused_file.update_root = { enable = opts.update_focused_file.update_root }
+    end
+  end
+  utils.move_missing_val(opts, "update_focused_file", "ignore_list", opts, "update_focused_file.update_root", "ignore_list", true)
 end
 
 local function deprecated(opts)
@@ -51,12 +70,12 @@ end
 
 local function removed(opts)
   if opts.auto_close then
-    notify.warn "auto close feature has been removed, see note in the README (tips & reminder section)"
+    notify.warn "auto close feature has been removed: https://github.com/nvim-tree/nvim-tree.lua/wiki/Auto-Close"
     opts.auto_close = nil
   end
 
   if opts.focus_empty_on_setup then
-    notify.warn "focus_empty_on_setup has been removed and will be replaced by a new startup configuration. Please remove this option. See https://bit.ly/3yJch2T"
+    notify.warn "focus_empty_on_setup has been removed: https://github.com/nvim-tree/nvim-tree.lua/wiki/Open-At-Startup"
     opts.focus_empty_on_setup = nil
   end
 

lua/nvim-tree/lib.lua

@@ -1,8 +1,9 @@
-local renderer = require "nvim-tree.renderer"
 local view = require "nvim-tree.view"
 local core = require "nvim-tree.core"
 local utils = require "nvim-tree.utils"
 local events = require "nvim-tree.events"
+local notify = require "nvim-tree.notify"
+local explorer_node = require "nvim-tree.explorer.node"
 
 ---@class LibOpenOpts
 ---@field path string|nil path
@@ -13,25 +14,33 @@ local M = {
   target_winid = nil,
 }
 
----@return Node|nil
+---Cursor position as per vim.api.nvim_win_get_cursor
-function M.get_node_at_cursor()
+---@return integer[]|nil
+function M.get_cursor_position()
   if not core.get_explorer() then
     return
   end
 
   local winnr = view.get_winnr()
-  if not winnr then
+  if not winnr or not vim.api.nvim_win_is_valid(winnr) then
     return
   end
 
-  local cursor = vim.api.nvim_win_get_cursor(view.get_winnr())
+  return vim.api.nvim_win_get_cursor(winnr)
-  local line = cursor[1]
+end
 
-  if line == 1 and view.is_root_folder_visible(core.get_cwd()) then
+---@return Node|nil
+function M.get_node_at_cursor()
+  local cursor = M.get_cursor_position()
+  if not cursor then
+    return
+  end
+
+  if cursor[1] == 1 and view.is_root_folder_visible(core.get_cwd()) then
     return { name = ".." }
   end
 
-  return utils.get_nodes_by_line(core.get_explorer().nodes, core.get_nodes_starting_line())[line]
+  return utils.get_nodes_by_line(core.get_explorer().nodes, core.get_nodes_starting_line())[cursor[1]]
 end
 
 ---Create a sanitized partial copy of a node, populating children recursively.
@@ -56,6 +65,7 @@ local function clone_node(node)
     name = node.name,
     open = node.open,
     type = node.type,
+    fs_stat = node.fs_stat,
   }
 
   if type(node.nodes) == "table" then
@@ -82,8 +92,35 @@ function M.get_last_group_node(node)
     node = node.group_next
   end
 
-  ---@diagnostic disable-next-line: return-type-mismatch -- it can't be nil
+  return node ---@diagnostic disable-line: return-type-mismatch -- it can't be nil
-  return node
+end
+
+---Group empty folders
+-- Recursively group nodes
+---@param node Node
+---@return Node[]
+function M.group_empty_folders(node)
+  local is_root = not node.parent
+  local child_folder_only = explorer_node.has_one_child_folder(node) and node.nodes[1]
+  if M.group_empty and not is_root and child_folder_only then
+    node.group_next = child_folder_only
+    local ns = M.group_empty_folders(child_folder_only)
+    node.nodes = ns or {}
+    return ns
+  end
+  return node.nodes
+end
+
+---Ungroup empty folders
+-- If a node is grouped, ungroup it: put node.group_next to the node.nodes and set node.group_next to nil
+---@param node Node
+function M.ungroup_empty_folders(node)
+  local cur = node
+  while cur and cur.group_next do
+    cur.nodes = { cur.group_next }
+    cur.group_next = nil
+    cur = cur.nodes[1]
+  end
 end
 
 ---@param node Node
@@ -98,22 +135,50 @@ function M.get_all_nodes_in_group(node)
   return nodes
 end
 
+-- Toggle group empty folders
+---@param head_node Node
+local function toggle_group_folders(head_node)
+  local is_grouped = head_node.group_next ~= nil
+
+  if is_grouped then
+    M.ungroup_empty_folders(head_node)
+  else
+    M.group_empty_folders(head_node)
+  end
+end
+
 ---@param node Node
-function M.expand_or_collapse(node)
+function M.expand_or_collapse(node, toggle_group)
+  local explorer = core.get_explorer()
+
+  toggle_group = toggle_group or false
   if node.has_children then
     node.has_children = false
   end
 
-  if #node.nodes == 0 then
+  if #node.nodes == 0 and explorer then
-    core.get_explorer():expand(node)
+    explorer:expand(node)
   end
 
-  local open = not M.get_last_group_node(node).open
+  local head_node = utils.get_parent_of_group(node)
-  for _, n in ipairs(M.get_all_nodes_in_group(node)) do
+  if toggle_group then
-    n.open = open
+    toggle_group_folders(head_node)
   end
 
-  renderer.draw()
+  local open = M.get_last_group_node(node).open
+  local next_open
+  if toggle_group then
+    next_open = open
+  else
+    next_open = not open
+  end
+  for _, n in ipairs(M.get_all_nodes_in_group(head_node)) do
+    n.open = next_open
+  end
+
+  if explorer then
+    explorer.renderer:draw()
+  end
 end
 
 function M.set_target_win()
@@ -138,14 +203,25 @@ local function open_view_and_draw()
   local cwd = vim.fn.getcwd()
   view.open()
   handle_buf_cwd(cwd)
-  renderer.draw()
+
+  local explorer = core.get_explorer()
+  if explorer then
+    explorer.renderer:draw()
+  end
 end
 
 local function should_hijack_current_buf()
   local bufnr = vim.api.nvim_get_current_buf()
   local bufname = vim.api.nvim_buf_get_name(bufnr)
-  local bufmodified = vim.api.nvim_buf_get_option(bufnr, "modified")
+
-  local ft = vim.api.nvim_buf_get_option(bufnr, "ft")
+  local bufmodified, ft
+  if vim.fn.has "nvim-0.10" == 1 then
+    bufmodified = vim.api.nvim_get_option_value("modified", { buf = bufnr })
+    ft = vim.api.nvim_get_option_value("ft", { buf = bufnr })
+  else
+    bufmodified = vim.api.nvim_buf_get_option(bufnr, "modified") ---@diagnostic disable-line: deprecated
+    ft = vim.api.nvim_buf_get_option(bufnr, "ft") ---@diagnostic disable-line: deprecated
+  end
 
   local should_hijack_unnamed = M.hijack_unnamed_buffer_when_opening and bufname == "" and not bufmodified and ft == ""
   local should_hijack_dir = bufname ~= "" and vim.fn.isdirectory(bufname) == 1 and M.hijack_directories.enable
@@ -157,8 +233,9 @@ end
 ---@param prompt_select string
 ---@param items_short string[]
 ---@param items_long string[]
+---@param kind string|nil
 ---@param callback fun(item_short: string)
-function M.prompt(prompt_input, prompt_select, items_short, items_long, callback)
+function M.prompt(prompt_input, prompt_select, items_short, items_long, kind, callback)
   local function format_item(short)
     for i, s in ipairs(items_short) do
       if short == s then
@@ -169,7 +246,7 @@ function M.prompt(prompt_input, prompt_select, items_short, items_long, callback
   end
 
   if M.select_prompts then
-    vim.ui.select(items_short, { prompt = prompt_select, format_item = format_item }, function(item_short)
+    vim.ui.select(items_short, { prompt = prompt_select, kind = kind, format_item = format_item }, function(item_short)
       callback(item_short)
     end)
   else
@@ -186,20 +263,37 @@ end
 function M.open(opts)
   opts = opts or {}
 
+  local explorer = core.get_explorer()
+
   M.set_target_win()
   if not core.get_explorer() or opts.path then
-    core.init(opts.path or vim.loop.cwd())
+    if opts.path then
+      core.init(opts.path)
+    else
+      local cwd, err = vim.loop.cwd()
+      if not cwd then
+        notify.error(string.format("current working directory unavailable: %s", err))
+        return
+      end
+      core.init(cwd)
+    end
   end
   if should_hijack_current_buf() then
     view.close_this_tab_only()
     view.open_in_win()
-    renderer.draw()
+    if explorer then
+      explorer.renderer:draw()
+    end
   elseif opts.winid then
     view.open_in_win { hijack_current_buf = false, resize = false, winid = opts.winid }
-    renderer.draw()
+    if explorer then
+      explorer.renderer:draw()
+    end
   elseif opts.current_window then
     view.open_in_win { hijack_current_buf = false, resize = false }
-    renderer.draw()
+    if explorer then
+      explorer.renderer:draw()
+    end
   else
     open_view_and_draw()
   end
@@ -212,6 +306,7 @@ function M.setup(opts)
   M.hijack_directories = opts.hijack_directories
   M.respect_buf_cwd = opts.respect_buf_cwd
   M.select_prompts = opts.select_prompts
+  M.group_empty = opts.renderer.group_empty
 end
 
 return M

lua/nvim-tree/marks/bulk-delete.lua

@@ -1,52 +0,0 @@
-local marks = require "nvim-tree.marks"
-local utils = require "nvim-tree.utils"
-local remove_file = require "nvim-tree.actions.fs.remove-file"
-local notify = require "nvim-tree.notify"
-local lib = require "nvim-tree.lib"
-
-local M = {
-  config = {},
-}
-
---- Delete nodes; each removal will be optionally notified
----@param nodes Node[]
-local function do_delete(nodes)
-  for _, node in pairs(nodes) do
-    remove_file.remove(node)
-  end
-
-  marks.clear_marks()
-
-  if not M.config.filesystem_watchers.enable then
-    require("nvim-tree.actions.reloaders.reloaders").reload_explorer()
-  end
-end
-
---- Delete marked nodes, optionally prompting
-function M.bulk_delete()
-  local nodes = marks.get_marks()
-  if not nodes or #nodes == 0 then
-    notify.warn "No bookmarksed to delete."
-    return
-  end
-
-  if M.config.ui.confirm.remove then
-    local prompt_select = "Remove bookmarked ?"
-    local prompt_input = prompt_select .. " y/N: "
-    lib.prompt(prompt_input, prompt_select, { "", "y" }, { "No", "Yes" }, function(item_short)
-      utils.clear_prompt()
-      if item_short == "y" then
-        do_delete(nodes)
-      end
-    end)
-  else
-    do_delete(nodes)
-  end
-end
-
-function M.setup(opts)
-  M.config.ui = opts.ui
-  M.config.filesystem_watchers = opts.filesystem_watchers
-end
-
-return M

lua/nvim-tree/marks/bulk-move.lua

@@ -1,52 +0,0 @@
-local marks = require "nvim-tree.marks"
-local core = require "nvim-tree.core"
-local utils = require "nvim-tree.utils"
-local rename_file = require "nvim-tree.actions.fs.rename-file"
-local notify = require "nvim-tree.notify"
-
-local M = {
-  config = {},
-}
-
-function M.bulk_move()
-  if #marks.get_marks() == 0 then
-    notify.warn "No bookmarks to move."
-    return
-  end
-
-  local input_opts = {
-    prompt = "Move to: ",
-    default = core.get_cwd(),
-    completion = "dir",
-  }
-
-  vim.ui.input(input_opts, function(location)
-    utils.clear_prompt()
-    if not location or location == "" then
-      return
-    end
-    if vim.fn.filewritable(location) ~= 2 then
-      notify.warn(location .. " is not writable, cannot move.")
-      return
-    end
-
-    local nodes = marks.get_marks()
-    for _, node in pairs(nodes) do
-      local head = vim.fn.fnamemodify(node.absolute_path, ":t")
-      local to = utils.path_join { location, head }
-      rename_file.rename(node, to)
-    end
-
-    marks.clear_marks()
-
-    if not M.config.filesystem_watchers.enable then
-      require("nvim-tree.actions.reloaders.reloaders").reload_explorer()
-    end
-  end)
-end
-
-function M.setup(opts)
-  M.config.filesystem_watchers = opts.filesystem_watchers
-end
-
-return M

lua/nvim-tree/marks/bulk-trash.lua

@@ -1,47 +0,0 @@
-local marks = require "nvim-tree.marks"
-local utils = require "nvim-tree.utils"
-local remove_file = require "nvim-tree.actions.fs.trash"
-local notify = require "nvim-tree.notify"
-local lib = require "nvim-tree.lib"
-
-local M = {
-  config = {},
-}
-
---- Delete nodes; each removal will be optionally notified
----@param nodes Node[]
-local function do_trash(nodes)
-  for _, node in pairs(nodes) do
-    remove_file.remove(node)
-  end
-
-  marks.clear_marks()
-end
-
-function M.bulk_trash()
-  local nodes = marks.get_marks()
-  if not nodes or #nodes == 0 then
-    notify.warn "No bookmarks to trash."
-    return
-  end
-
-  if M.config.ui.confirm.trash then
-    local prompt_select = "Trash bookmarked ?"
-    local prompt_input = prompt_select .. " y/N: "
-    lib.prompt(prompt_input, prompt_select, { "", "y" }, { "No", "Yes" }, function(item_short)
-      utils.clear_prompt()
-      if item_short == "y" then
-        do_trash(nodes)
-      end
-    end)
-  else
-    do_trash(nodes)
-  end
-end
-
-function M.setup(opts)
-  M.config.ui = opts.ui
-  M.config.filesystem_watchers = opts.filesystem_watchers
-end
-
-return M

lua/nvim-tree/marks/init.lua

@@ -1,68 +1,272 @@
-local renderer = {} -- circular dependency
+local Iterator = require "nvim-tree.iterators.node-iterator"
+local core = require "nvim-tree.core"
+local lib = require "nvim-tree.lib"
+local notify = require "nvim-tree.notify"
+local open_file = require "nvim-tree.actions.node.open-file"
+local remove_file = require "nvim-tree.actions.fs.remove-file"
+local rename_file = require "nvim-tree.actions.fs.rename-file"
+local trash = require "nvim-tree.actions.fs.trash"
+local utils = require "nvim-tree.utils"
 
-local NvimTreeMarks = {}
+---@class Marks
+---@field config table hydrated user opts.filters
+---@field private explorer Explorer
+---@field private marks table<string, Node> by absolute path
+local Marks = {}
 
-local M = {}
+---@return Marks
+---@param opts table user options
+---@param explorer Explorer
+function Marks:new(opts, explorer)
+  local o = {
+    explorer = explorer,
+    config = {
+      ui = opts.ui,
+      filesystem_watchers = opts.filesystem_watchers,
+    },
+    marks = {},
+  }
 
----@class MinimalNode
+  setmetatable(o, self)
----@field absolute_path string
+  self.__index = self
-
+  return o
----@param node Node|MinimalNode
-local function add_mark(node)
-  NvimTreeMarks[node.absolute_path] = node
-
-  renderer.draw()
 end
 
----@param node Node|MinimalNode
+---Clear all marks and reload if watchers disabled
-local function remove_mark(node)
+---@private
-  NvimTreeMarks[node.absolute_path] = nil
+function Marks:clear_reload()
-
+  self:clear()
-  renderer.draw()
+  if not self.config.filesystem_watchers.enable then
+    self.explorer:reload_explorer()
+  end
 end
 
----@param node Node|MinimalNode
+---Clear all marks and redraw
-function M.toggle_mark(node)
+---@public
+function Marks:clear()
+  self.marks = {}
+  self.explorer.renderer:draw()
+end
+
+---@public
+---@param node Node
+function Marks:toggle(node)
   if node.absolute_path == nil then
     return
   end
 
-  if M.get_mark(node) then
+  if self:get(node) then
-    remove_mark(node)
+    self.marks[node.absolute_path] = nil
   else
-    add_mark(node)
+    self.marks[node.absolute_path] = node
   end
 
-  renderer.draw()
+  self.explorer.renderer:draw()
 end
 
-function M.clear_marks()
+---Return node if marked
-  NvimTreeMarks = {}
+---@public
-
+---@param node Node
-  renderer.draw()
+---@return Node|nil
+function Marks:get(node)
+  return node and self.marks[node.absolute_path]
 end
 
----@param node Node|MinimalNode
+---List marked nodes
----@return table|nil
+---@public
-function M.get_mark(node)
+---@return Node[]
-  return NvimTreeMarks[node.absolute_path]
+function Marks:list()
-end
-
----@return table
-function M.get_marks()
   local list = {}
-  for _, node in pairs(NvimTreeMarks) do
+  for _, node in pairs(self.marks) do
     table.insert(list, node)
   end
   return list
 end
 
-function M.setup(opts)
+---Delete marked; each removal will be optionally notified
-  renderer = require "nvim-tree.renderer"
+---@public
+function Marks:bulk_delete()
+  if not next(self.marks) then
+    notify.warn "No bookmarks to delete."
+    return
+  end
 
-  require("nvim-tree.marks.bulk-delete").setup(opts)
+  local function execute()
-  require("nvim-tree.marks.bulk-trash").setup(opts)
+    for _, node in pairs(self.marks) do
-  require("nvim-tree.marks.bulk-move").setup(opts)
+      remove_file.remove(node)
+    end
+    self:clear_reload()
+  end
+
+  if self.config.ui.confirm.remove then
+    local prompt_select = "Remove bookmarked ?"
+    local prompt_input = prompt_select .. " y/N: "
+    lib.prompt(prompt_input, prompt_select, { "", "y" }, { "No", "Yes" }, "nvimtree_bulk_delete", function(item_short)
+      utils.clear_prompt()
+      if item_short == "y" then
+        execute()
+      end
+    end)
+  else
+    execute()
+  end
 end
 
-return M
+---Trash marked; each removal will be optionally notified
+---@public
+function Marks:bulk_trash()
+  if not next(self.marks) then
+    notify.warn "No bookmarks to trash."
+    return
+  end
+
+  local function execute()
+    for _, node in pairs(self.marks) do
+      trash.remove(node)
+    end
+    self:clear_reload()
+  end
+
+  if self.config.ui.confirm.trash then
+    local prompt_select = "Trash bookmarked ?"
+    local prompt_input = prompt_select .. " y/N: "
+    lib.prompt(prompt_input, prompt_select, { "", "y" }, { "No", "Yes" }, "nvimtree_bulk_trash", function(item_short)
+      utils.clear_prompt()
+      if item_short == "y" then
+        execute()
+      end
+    end)
+  else
+    execute()
+  end
+end
+
+---Move marked
+---@public
+function Marks:bulk_move()
+  if not next(self.marks) then
+    notify.warn "No bookmarks to move."
+    return
+  end
+
+  local node_at_cursor = lib.get_node_at_cursor()
+  local default_path = core.get_cwd()
+
+  if node_at_cursor and node_at_cursor.type == "directory" then
+    default_path = node_at_cursor.absolute_path
+  elseif node_at_cursor and node_at_cursor.parent then
+    default_path = node_at_cursor.parent.absolute_path
+  end
+
+  local input_opts = {
+    prompt = "Move to: ",
+    default = default_path,
+    completion = "dir",
+  }
+
+  vim.ui.input(input_opts, function(location)
+    utils.clear_prompt()
+    if not location or location == "" then
+      return
+    end
+    if vim.fn.filewritable(location) ~= 2 then
+      notify.warn(location .. " is not writable, cannot move.")
+      return
+    end
+
+    for _, node in pairs(self.marks) do
+      local head = vim.fn.fnamemodify(node.absolute_path, ":t")
+      local to = utils.path_join { location, head }
+      rename_file.rename(node, to)
+    end
+
+    self:clear_reload()
+  end)
+end
+
+---Focus nearest marked node in direction.
+---@private
+---@param up boolean
+function Marks:navigate(up)
+  local node = lib.get_node_at_cursor()
+  if not node then
+    return
+  end
+
+  local first, prev, next, last = nil, nil, nil, nil
+  local found = false
+
+  Iterator.builder(self.explorer.nodes)
+    :recursor(function(n)
+      return n.open and n.nodes
+    end)
+    :applier(function(n)
+      if n.absolute_path == node.absolute_path then
+        found = true
+        return
+      end
+
+      if not self:get(n) then
+        return
+      end
+
+      last = n
+      first = first or n
+
+      if found and not next then
+        next = n
+      end
+
+      if not found then
+        prev = n
+      end
+    end)
+    :iterate()
+
+  if not found then
+    return
+  end
+
+  if up then
+    utils.focus_node_or_parent(prev or last)
+  else
+    utils.focus_node_or_parent(next or first)
+  end
+end
+
+---@public
+function Marks:navigate_prev()
+  self:navigate(true)
+end
+
+---@public
+function Marks:navigate_next()
+  self:navigate(false)
+end
+
+---Prompts for selection of a marked node, sorted by absolute paths.
+---A folder will be focused, a file will be opened.
+---@public
+function Marks:navigate_select()
+  local list = vim.tbl_map(function(n)
+    return n.absolute_path
+  end, self:list())
+
+  table.sort(list)
+
+  vim.ui.select(list, {
+    prompt = "Select a file to open or a folder to focus",
+  }, function(choice)
+    if not choice or choice == "" then
+      return
+    end
+    local node = self.marks[choice]
+    if node and not node.nodes and not utils.get_win_buf_from_path(node.absolute_path) then
+      open_file.fn("edit", node.absolute_path)
+    elseif node then
+      utils.focus_file(node.absolute_path)
+    end
+  end)
+end
+
+return Marks

lua/nvim-tree/marks/navigation.lua

@@ -1,102 +0,0 @@
-local Iterator = require "nvim-tree.iterators.node-iterator"
-local core = require "nvim-tree.core"
-local Marks = require "nvim-tree.marks"
-local open_file = require "nvim-tree.actions.node.open-file"
-local utils = require "nvim-tree.utils"
-local lib = require "nvim-tree.lib"
-
----@param node table
----@param where string
----@return Node|nil
-local function get_nearest(node, where)
-  local first, prev, next, last = nil, nil, nil, nil
-  local found = false
-
-  Iterator.builder(core.get_explorer().nodes)
-    :recursor(function(n)
-      return n.open and n.nodes
-    end)
-    :applier(function(n)
-      if n.absolute_path == node.absolute_path then
-        found = true
-        return
-      end
-
-      if not Marks.get_mark(n) then
-        return
-      end
-
-      last = n
-      first = first or n
-
-      if found and not next then
-        next = n
-      end
-
-      if not found then
-        prev = n
-      end
-    end)
-    :iterate()
-
-  if not found then
-    return
-  end
-
-  if where == "next" then
-    return next or first
-  else
-    return prev or last
-  end
-end
-
----@param where string
----@param node table|nil
----@return Node|nil
-local function get(where, node)
-  if node then
-    return get_nearest(node, where)
-  end
-end
-
----@param node table|nil
-local function open_or_focus(node)
-  if node and not node.nodes and not utils.get_win_buf_from_path(node.absolute_path) then
-    open_file.fn("edit", node.absolute_path)
-  elseif node then
-    utils.focus_file(node.absolute_path)
-  end
-end
-
----@param where string
----@return function
-local function navigate_to(where)
-  return function()
-    local node = lib.get_node_at_cursor()
-    local next = get(where, node)
-    open_or_focus(next)
-  end
-end
-
-local M = {}
-
-M.next = navigate_to "next"
-M.prev = navigate_to "prev"
-
-function M.select()
-  local list = vim.tbl_map(function(n)
-    return n.absolute_path
-  end, Marks.get_marks())
-
-  vim.ui.select(list, {
-    prompt = "Select a file to open or a folder to focus",
-  }, function(choice)
-    if not choice or choice == "" then
-      return
-    end
-    local node = Marks.get_mark { absolute_path = choice }
-    open_or_focus(node)
-  end)
-end
-
-return M

lua/nvim-tree/modified.lua

@@ -1,40 +0,0 @@
-local M = {}
-
----@type table<string, boolean> record of which file is modified
-M._record = {}
-
----refresh M.record
-function M.reload()
-  M._record = {}
-  local bufs = vim.fn.getbufinfo { bufmodified = true, buflisted = true }
-  for _, buf in pairs(bufs) do
-    local path = buf.name
-    if path ~= "" then -- not a [No Name] buffer
-      -- mark all the parent as modified as well
-      while
-        M._record[path] ~= true
-        -- no need to keep going if already recorded
-        -- This also prevents an infinite loop
-      do
-        M._record[path] = true
-        path = vim.fn.fnamemodify(path, ":h")
-      end
-    end
-  end
-end
-
----@param node Node
----@return boolean
-function M.is_modified(node)
-  return M.config.enable
-    and M._record[node.absolute_path]
-    and (not node.nodes or M.config.show_on_dirs)
-    and (not node.open or M.config.show_on_open_dirs)
-end
-
----@param opts table
-function M.setup(opts)
-  M.config = opts.modified
-end
-
-return M

lua/nvim-tree/node.lua

@@ -1,28 +1,27 @@
 ---@meta
 
--- TODO add "${3rd}/luv/library" to "workspace.library"
----@class uv.uv_req_t: table
----@class uv.uv_fs_t: uv.uv_req_t
-
 ---@class ParentNode
 ---@field name string
 
 ---@class BaseNode
 ---@field absolute_path string
 ---@field executable boolean
----@field fs_stat uv.uv_fs_t
+---@field fs_stat uv.fs_stat.result|nil
 ---@field git_status GitStatus|nil
 ---@field hidden boolean
+---@field is_dot boolean
 ---@field name string
 ---@field parent DirNode
 ---@field type string
 ---@field watcher function|nil
+---@field diag_status DiagStatus|nil
 
 ---@class DirNode: BaseNode
 ---@field has_children boolean
 ---@field group_next Node|nil
 ---@field nodes Node[]
 ---@field open boolean
+---@field hidden_stats table -- Each field of this table is a key for source and value for count
 
 ---@class FileNode: BaseNode
 ---@field extension string

lua/nvim-tree/renderer/builder.lua

@@ -1,136 +1,111 @@
-local utils = require "nvim-tree.utils"
-local core = require "nvim-tree.core"
 local notify = require "nvim-tree.notify"
+local utils = require "nvim-tree.utils"
+local view = require "nvim-tree.view"
+
+local DecoratorBookmarks = require "nvim-tree.renderer.decorator.bookmarks"
+local DecoratorCopied = require "nvim-tree.renderer.decorator.copied"
+local DecoratorCut = require "nvim-tree.renderer.decorator.cut"
+local DecoratorDiagnostics = require "nvim-tree.renderer.decorator.diagnostics"
+local DecoratorGit = require "nvim-tree.renderer.decorator.git"
+local DecoratorModified = require "nvim-tree.renderer.decorator.modified"
+local DecoratorHidden = require "nvim-tree.renderer.decorator.hidden"
+local DecoratorOpened = require "nvim-tree.renderer.decorator.opened"
 
-local git = require "nvim-tree.renderer.components.git"
 local pad = require "nvim-tree.renderer.components.padding"
 local icons = require "nvim-tree.renderer.components.icons"
-local modified = require "nvim-tree.renderer.components.modified"
-local diagnostics = require "nvim-tree.renderer.components.diagnostics"
-local bookmarks = require "nvim-tree.renderer.components.bookmarks"
 
-local HL_POSITION = require("nvim-tree.enum").HL_POSITION
+local PICTURE_MAP = {
+  jpg = true,
+  jpeg = true,
+  png = true,
+  gif = true,
+  webp = true,
+  jxl = true,
+}
 
+---@class (exact) HighlightedString
+---@field str string
+---@field hl string[]
+
+---@class (exact) AddHighlightArgs
+---@field group string[]
+---@field line number
+---@field col_start number
+---@field col_end number
+
+---@class (exact) Builder
+---@field private __index? table
+---@field lines string[] includes icons etc.
+---@field hl_args AddHighlightArgs[] line highlights
+---@field signs string[] line signs
+---@field extmarks table[] extra marks for right icon placement
+---@field virtual_lines table[] virtual lines for hidden count display
+---@field private explorer Explorer
+---@field private index number
+---@field private depth number
+---@field private combined_groups table<string, boolean> combined group names
+---@field private markers boolean[] indent markers
+---@field private decorators Decorator[]
+---@field private hidden_display fun(node: Node): string|nil
 local Builder = {}
-Builder.__index = Builder
 
-local DEFAULT_ROOT_FOLDER_LABEL = ":~:s?$?/..?"
+---@param opts table user options
-
+---@param explorer Explorer
-function Builder.new(root_cwd)
+---@return Builder
-  return setmetatable({
+function Builder:new(opts, explorer)
+  ---@type Builder
+  local o = {
+    opts = opts,
+    explorer = explorer,
     index = 0,
     depth = 0,
-    highlights = {},
+    hl_args = {},
+    combined_groups = {},
     lines = {},
     markers = {},
     signs = {},
-    root_cwd = root_cwd,
+    extmarks = {},
-  }, Builder)
+    virtual_lines = {},
+    decorators = {
+      -- priority order
+      DecoratorCut:new(opts, explorer),
+      DecoratorCopied:new(opts, explorer),
+      DecoratorDiagnostics:new(opts, explorer),
+      DecoratorBookmarks:new(opts, explorer),
+      DecoratorModified:new(opts, explorer),
+      DecoratorHidden:new(opts, explorer),
+      DecoratorOpened:new(opts, explorer),
+      DecoratorGit:new(opts, explorer),
+    },
+    hidden_display = Builder:setup_hidden_display_function(opts),
+  }
+
+  setmetatable(o, self)
+  self.__index = self
+
+  return o
 end
 
-function Builder:configure_root_label(root_folder_label)
+---Insert ranged highlight groups into self.highlights
-  self.root_folder_label = root_folder_label or DEFAULT_ROOT_FOLDER_LABEL
+---@private
-  return self
+---@param groups string[]
+---@param start number
+---@param end_ number|nil
+function Builder:insert_highlight(groups, start, end_)
+  table.insert(self.hl_args, { groups, self.index, start, end_ or -1 })
 end
 
-function Builder:configure_trailing_slash(with_trailing)
+---@private
-  self.trailing_slash = with_trailing and "/" or ""
+function Builder:get_folder_name(node)
-  return self
-end
-
-function Builder:configure_special_files(special_files)
-  self.special_files = special_files
-  return self
-end
-
-function Builder:configure_picture_map(picture_map)
-  self.picture_map = picture_map
-  return self
-end
-
-function Builder:configure_filter(filter, prefix)
-  self.filter_prefix = prefix
-  self.filter = filter
-  return self
-end
-
-function Builder:configure_opened_file_highlighting(highlight_opened_files)
-  self.highlight_opened_files = highlight_opened_files
-  return self
-end
-
-function Builder:configure_modified_highlighting(highlight_modified)
-  self.highlight_modified = highlight_modified
-  return self
-end
-
-function Builder:configure_icon_padding(padding)
-  self.icon_padding = padding or " "
-  return self
-end
-
-function Builder:configure_git_icons_placement(where)
-  if where ~= "after" and where ~= "before" and where ~= "signcolumn" then
-    where = "before" -- default before
-  end
-  self.git_placement = where
-  return self
-end
-
-function Builder:configure_diagnostics_icon_placement(where)
-  if where ~= "after" and where ~= "before" and where ~= "signcolumn" then
-    where = "before" -- default before
-  end
-  self.diagnostics_placement = where
-  return self
-end
-
-function Builder:configure_bookmark_icon_placement(where)
-  if where ~= "after" and where ~= "before" and where ~= "signcolumn" then
-    where = "before" -- default before
-  end
-  self.bookmarks_placement = where
-  return self
-end
-
-function Builder:configure_modified_placement(where)
-  if where ~= "after" and where ~= "before" and where ~= "signcolumn" then
-    where = "after" -- default after
-  end
-  self.modified_placement = where
-  return self
-end
-
-function Builder:configure_symlink_destination(show)
-  self.symlink_destination = show
-  return self
-end
-
-function Builder:configure_group_name_modifier(group_name_modifier)
-  if type(group_name_modifier) == "function" then
-    self.group_name_modifier = group_name_modifier
-  end
-  return self
-end
-
-function Builder:_insert_highlight(group, start, end_)
-  table.insert(self.highlights, { group, self.index, start, end_ or -1 })
-end
-
-function Builder:_insert_line(line)
-  table.insert(self.lines, line)
-end
-
-function Builder:_get_folder_name(node)
   local name = node.name
   local next = node.group_next
   while next do
-    name = name .. "/" .. next.name
+    name = string.format("%s/%s", name, next.name)
     next = next.group_next
   end
 
-  if node.group_next and self.group_name_modifier then
+  if node.group_next and type(self.opts.renderer.group_empty) == "function" then
-    local new_name = self.group_name_modifier(name)
+    local new_name = self.opts.renderer.group_empty(name)
     if type(new_name) == "string" then
       name = new_name
     else
@@ -138,16 +113,13 @@ function Builder:_get_folder_name(node)
     end
   end
 
-  return name .. self.trailing_slash
+  return string.format("%s%s", name, self.opts.renderer.add_trailing and "/" or "")
 end
 
----@class HighlightedString
+---@private
----@field str string
----@field hl string[]
-
 ---@param highlighted_strings HighlightedString[]
 ---@return string
-function Builder:_unwrap_highlighted_strings(highlighted_strings)
+function Builder:unwrap_highlighted_strings(highlighted_strings)
   if not highlighted_strings then
     return ""
   end
@@ -156,21 +128,22 @@ function Builder:_unwrap_highlighted_strings(highlighted_strings)
   for _, v in ipairs(highlighted_strings) do
     if #v.str > 0 then
       if v.hl and type(v.hl) == "table" then
-        self:_insert_highlight(v.hl, #string, #string + #v.str)
+        self:insert_highlight(v.hl, #string, #string + #v.str)
       end
-      string = string .. v.str
+      string = string.format("%s%s", string, v.str)
     end
   end
   return string
 end
 
+---@private
 ---@param node table
 ---@return HighlightedString icon
 ---@return HighlightedString name
-function Builder:_build_folder(node)
+function Builder:build_folder(node)
   local has_children = #node.nodes ~= 0 or node.has_children
   local icon, icon_hl = icons.get_folder_icon(node, has_children)
-  local foldername = self:_get_folder_name(node)
+  local foldername = self:get_folder_name(node)
 
   if #icon > 0 and icon_hl == nil then
     if node.open then
@@ -181,12 +154,14 @@ function Builder:_build_folder(node)
   end
 
   local foldername_hl = "NvimTreeFolderName"
-  if node.link_to and self.symlink_destination then
+  if node.link_to and self.opts.renderer.symlink_destination then
     local arrow = icons.i.symlink_arrow
-    local link_to = utils.path_relative(node.link_to, core.get_cwd())
+    local link_to = utils.path_relative(node.link_to, self.explorer.absolute_path)
-    foldername = foldername .. arrow .. link_to
+    foldername = string.format("%s%s%s", foldername, arrow, link_to)
     foldername_hl = "NvimTreeSymlinkFolderName"
-  elseif vim.tbl_contains(self.special_files, node.absolute_path) or vim.tbl_contains(self.special_files, node.name) then
+  elseif
+    vim.tbl_contains(self.opts.renderer.special_files, node.absolute_path) or vim.tbl_contains(self.opts.renderer.special_files, node.name)
+  then
     foldername_hl = "NvimTreeSpecialFolderName"
   elseif node.open then
     foldername_hl = "NvimTreeOpenedFolderName"
@@ -197,174 +172,58 @@ function Builder:_build_folder(node)
   return { str = icon, hl = { icon_hl } }, { str = foldername, hl = { foldername_hl } }
 end
 
+---@private
 ---@param node table
 ---@return HighlightedString icon
 ---@return HighlightedString name
-function Builder:_build_symlink(node)
+function Builder:build_symlink(node)
   local icon = icons.i.symlink
   local arrow = icons.i.symlink_arrow
   local symlink_formatted = node.name
-  if self.symlink_destination then
+  if self.opts.renderer.symlink_destination then
-    local link_to = utils.path_relative(node.link_to, core.get_cwd())
+    local link_to = utils.path_relative(node.link_to, self.explorer.absolute_path)
-    symlink_formatted = symlink_formatted .. arrow .. link_to
+    symlink_formatted = string.format("%s%s%s", symlink_formatted, arrow, link_to)
   end
 
   return { str = icon, hl = { "NvimTreeSymlinkIcon" } }, { str = symlink_formatted, hl = { "NvimTreeSymlink" } }
 end
 
----@param node table
+---@private
----@return HighlightedString icon
-function Builder:_build_file_icon(node)
-  local icon, hl_group = icons.get_file_icon(node.name, node.extension)
-  return { str = icon, hl = { hl_group } }
-end
-
 ---@param node table
 ---@return HighlightedString icon
 ---@return HighlightedString name
-function Builder:_build_file(node)
+function Builder:build_file(node)
-  local icon = self:_build_file_icon(node)
-
   local hl
-  if vim.tbl_contains(self.special_files, node.absolute_path) or vim.tbl_contains(self.special_files, node.name) then
+  if
+    vim.tbl_contains(self.opts.renderer.special_files, node.absolute_path) or vim.tbl_contains(self.opts.renderer.special_files, node.name)
+  then
     hl = "NvimTreeSpecialFile"
   elseif node.executable then
     hl = "NvimTreeExecFile"
-  elseif self.picture_map[node.extension] then
+  elseif PICTURE_MAP[node.extension] then
     hl = "NvimTreeImageFile"
   end
 
-  return icon, { str = node.name, hl = { hl } }
+  local icon, hl_group = icons.get_file_icon(node.name, node.extension)
-end
+  return { str = icon, hl = { hl_group } }, { str = node.name, hl = { hl } }
-
----@param node table
----@return HighlightedString[]|nil icon
-function Builder:_get_git_icons(node)
-  local git_icons = git.get_icons(node)
-  if git_icons and #git_icons > 0 and self.git_placement == "signcolumn" then
-    table.insert(self.signs, {
-      sign = git_icons[1].hl[1],
-      lnum = self.index + 1,
-      priority = 1,
-    })
-    git_icons = nil
-  end
-  return git_icons
-end
-
----@param node table
----@return HighlightedString[]|nil icon
-function Builder:_get_diagnostics_icon(node)
-  local diagnostics_icon = diagnostics.get_icon(node)
-  if diagnostics_icon and self.diagnostics_placement == "signcolumn" then
-    table.insert(self.signs, {
-      sign = diagnostics_icon.hl[1],
-      lnum = self.index + 1,
-      priority = 2,
-    })
-    diagnostics_icon = nil
-  end
-  return diagnostics_icon
-end
-
----@param node table
----@return HighlightedString|nil icon
-function Builder:_get_modified_icon(node)
-  local modified_icon = modified.get_icon(node)
-  if modified_icon and self.modified_placement == "signcolumn" then
-    table.insert(self.signs, {
-      sign = modified_icon.hl[1],
-      lnum = self.index + 1,
-      priority = 3,
-    })
-    modified_icon = nil
-  end
-  return modified_icon
-end
-
----@param node table
----@return HighlightedString[]|nil icon
-function Builder:_get_bookmark_icon(node)
-  local bookmark_icon = bookmarks.get_icon(node)
-  if bookmark_icon and self.bookmarks_placement == "signcolumn" then
-    table.insert(self.signs, {
-      sign = bookmark_icon.hl[1],
-      lnum = self.index + 1,
-      priority = 4,
-    })
-    bookmark_icon = nil
-  end
-  return bookmark_icon
-end
-
----@param node table
----@return string|nil icon_hl
----@return string|nil name_hl
-function Builder:_get_highlight_override(node, unloaded_bufnr)
-  local name_hl, icon_hl
-
-  -- git
-  local git_highlight = git.get_highlight(node)
-  if git_highlight then
-    name_hl = git_highlight
-  end
-
-  -- opened file
-  if self.highlight_opened_files and vim.fn.bufloaded(node.absolute_path) > 0 and vim.fn.bufnr(node.absolute_path) ~= unloaded_bufnr then
-    if self.highlight_opened_files == "all" or self.highlight_opened_files == "name" then
-      name_hl = "NvimTreeOpenedFile"
-    end
-    if self.highlight_opened_files == "all" or self.highlight_opened_files == "icon" then
-      icon_hl = "NvimTreeOpenedFileIcon"
-    end
-  end
-
-  -- modified file
-  local modified_highlight = modified.get_highlight(node)
-  if modified_highlight then
-    if self.highlight_modified == "all" or self.highlight_modified == "name" then
-      name_hl = modified_highlight
-    end
-    if self.highlight_modified == "all" or self.highlight_modified == "icon" then
-      icon_hl = modified_highlight
-    end
-  end
-
-  return icon_hl, name_hl
-end
-
----Append optional highlighting to icon or name.
----@param node table
----@param get_hl fun(node: table): HL_POSITION, string
----@param icon_hl string[] icons to append to
----@param name_hl string[] names to append to
-function Builder:_append_highlight(node, get_hl, icon_hl, name_hl)
-  local pos, hl = get_hl(node)
-  if pos ~= HL_POSITION.none and hl then
-    if pos == HL_POSITION.all or pos == HL_POSITION.icon then
-      table.insert(icon_hl, hl)
-    end
-    if pos == HL_POSITION.all or pos == HL_POSITION.name then
-      table.insert(name_hl, hl)
-    end
-  end
 end
 
+---@private
 ---@param indent_markers HighlightedString[]
 ---@param arrows HighlightedString[]|nil
 ---@param icon HighlightedString
 ---@param name HighlightedString
----@param git_icons HighlightedString[]|nil
+---@param node table
----@param diagnostics_icon HighlightedString|nil
----@param modified_icon HighlightedString|nil
----@param bookmark_icon HighlightedString|nil
 ---@return HighlightedString[]
-function Builder:_format_line(indent_markers, arrows, icon, name, git_icons, diagnostics_icon, modified_icon, bookmark_icon)
+function Builder:format_line(indent_markers, arrows, icon, name, node)
   local added_len = 0
   local function add_to_end(t1, t2)
+    if not t2 then
+      return
+    end
     for _, v in ipairs(t2) do
       if added_len > 0 then
-        table.insert(t1, { str = self.icon_padding })
+        table.insert(t1, { str = self.opts.renderer.icons.padding })
       end
       table.insert(t1, v)
     end
@@ -379,92 +238,174 @@ function Builder:_format_line(indent_markers, arrows, icon, name, git_icons, dia
 
   local line = { indent_markers, arrows }
   add_to_end(line, { icon })
-  if git_icons and self.git_placement == "before" then
+
-    add_to_end(line, git_icons)
+  for i = #self.decorators, 1, -1 do
-  end
+    add_to_end(line, self.decorators[i]:icons_before(node))
-  if modified_icon and self.modified_placement == "before" then
-    add_to_end(line, { modified_icon })
-  end
-  if diagnostics_icon and self.diagnostics_placement == "before" then
-    add_to_end(line, { diagnostics_icon })
-  end
-  if bookmark_icon and self.bookmarks_placement == "before" then
-    add_to_end(line, { bookmark_icon })
   end
 
   add_to_end(line, { name })
 
-  if git_icons and self.git_placement == "after" then
+  for i = #self.decorators, 1, -1 do
-    add_to_end(line, git_icons)
+    add_to_end(line, self.decorators[i]:icons_after(node))
   end
-  if modified_icon and self.modified_placement == "after" then
+
-    add_to_end(line, { modified_icon })
+  local rights = {}
+  for i = #self.decorators, 1, -1 do
+    add_to_end(rights, self.decorators[i]:icons_right_align(node))
   end
-  if diagnostics_icon and self.diagnostics_placement == "after" then
+  if #rights > 0 then
-    add_to_end(line, { diagnostics_icon })
+    self.extmarks[self.index] = rights
-  end
-  if bookmark_icon and self.bookmarks_placement == "after" then
-    add_to_end(line, { bookmark_icon })
   end
 
   return line
 end
 
-function Builder:_build_line(node, idx, num_children, unloaded_bufnr)
+---@private
-  local copy_paste = require "nvim-tree.actions.fs.copy-paste"
+---@param node Node
+function Builder:build_signs(node)
+  -- first in priority order
+  local sign_name
+  for _, d in ipairs(self.decorators) do
+    sign_name = d:sign_name(node)
+    if sign_name then
+      self.signs[self.index] = sign_name
+      break
+    end
+  end
+end
 
+---Create a highlight group for groups with later groups overriding previous.
+---Combined group name is less than the 200 byte limit of highlight group names
+---@private
+---@param groups string[] highlight group names
+---@return string group_name "NvimTreeCombinedHL" .. sha256
+function Builder:create_combined_group(groups)
+  local combined_name = string.format("NvimTreeCombinedHL%s", vim.fn.sha256(table.concat(groups)))
+
+  -- only create if necessary
+  if not self.combined_groups[combined_name] then
+    self.combined_groups[combined_name] = true
+    local combined_hl = {}
+
+    -- build the highlight, overriding values
+    for _, group in ipairs(groups) do
+      local hl = vim.api.nvim_get_hl(0, { name = group, link = false })
+      combined_hl = vim.tbl_extend("force", combined_hl, hl)
+    end
+
+    -- add highlights to the global namespace
+    vim.api.nvim_set_hl(0, combined_name, combined_hl)
+
+    table.insert(self.combined_groups, combined_name)
+  end
+
+  return combined_name
+end
+
+---Calculate highlight group for icon and name. A combined highlight group will be created
+---when there is more than one highlight.
+---A highlight group is always calculated and upserted for the case of highlights changing.
+---@private
+---@param node Node
+---@return string|nil icon_hl_group
+---@return string|nil name_hl_group
+function Builder:add_highlights(node)
+  -- result
+  local icon_hl_group, name_hl_group
+
+  -- calculate all groups
+  local icon_groups = {}
+  local name_groups = {}
+  local d, icon, name
+  for i = #self.decorators, 1, -1 do
+    d = self.decorators[i]
+    icon, name = d:groups_icon_name(node)
+    table.insert(icon_groups, icon)
+    table.insert(name_groups, name)
+  end
+
+  -- one or many icon groups
+  if #icon_groups > 1 then
+    icon_hl_group = self:create_combined_group(icon_groups)
+  else
+    icon_hl_group = icon_groups[1]
+  end
+
+  -- one or many name groups
+  if #name_groups > 1 then
+    name_hl_group = self:create_combined_group(name_groups)
+  else
+    name_hl_group = name_groups[1]
+  end
+
+  return icon_hl_group, name_hl_group
+end
+
+---@private
+function Builder:build_line(node, idx, num_children)
   -- various components
   local indent_markers = pad.get_indent_markers(self.depth, idx, num_children, node, self.markers)
   local arrows = pad.get_arrows(node)
 
-  -- adds icons to signcolumn
-  local bookmark_icon = self:_get_bookmark_icon(node)
-  local git_icons = self:_get_git_icons(node)
-  local modified_icon = self:_get_modified_icon(node)
-  local diagnostics_icon = self:_get_diagnostics_icon(node)
-
   -- main components
   local is_folder = node.nodes ~= nil
   local is_symlink = node.link_to ~= nil
   local icon, name
   if is_folder then
-    icon, name = self:_build_folder(node)
+    icon, name = self:build_folder(node)
   elseif is_symlink then
-    icon, name = self:_build_symlink(node)
+    icon, name = self:build_symlink(node)
   else
-    icon, name = self:_build_file(node)
+    icon, name = self:build_file(node)
   end
 
-  -- highlight override
+  -- highighting
-  local icon_hl_override, name_hl_override = self:_get_highlight_override(node, unloaded_bufnr)
+  local icon_hl_group, name_hl_group = self:add_highlights(node)
-  if icon_hl_override then
+  table.insert(icon.hl, icon_hl_group)
-    icon.hl = { icon_hl_override }
+  table.insert(name.hl, name_hl_group)
-  end
-  if name_hl_override then
-    name.hl = { name_hl_override }
-  end
 
-  -- extra highighting
+  local line = self:format_line(indent_markers, arrows, icon, name, node)
-  self:_append_highlight(node, bookmarks.get_highlight, icon.hl, name.hl)
+  table.insert(self.lines, self:unwrap_highlighted_strings(line))
-  self:_append_highlight(node, diagnostics.get_highlight, icon.hl, name.hl)
-  self:_append_highlight(node, copy_paste.get_highlight, icon.hl, name.hl)
-
-  local line = self:_format_line(indent_markers, arrows, icon, name, git_icons, diagnostics_icon, modified_icon, bookmark_icon)
-  self:_insert_line(self:_unwrap_highlighted_strings(line))
 
   self.index = self.index + 1
 
   node = require("nvim-tree.lib").get_last_group_node(node)
-
   if node.open then
     self.depth = self.depth + 1
-    self:build(node, unloaded_bufnr)
+    self:build_lines(node)
     self.depth = self.depth - 1
   end
 end
 
-function Builder:_get_nodes_number(nodes)
+---Add virtual lines for rendering hidden count information per node
-  if not self.filter then
+---@private
+function Builder:add_hidden_count_string(node, idx, num_children)
+  if not node.open then
+    return
+  end
+  local hidden_count_string = self.hidden_display(node.hidden_stats)
+  if hidden_count_string and hidden_count_string ~= "" then
+    local indent_markers = pad.get_indent_markers(self.depth, idx or 0, num_children or 0, node, self.markers, 1)
+    local indent_width = self.opts.renderer.indent_width
+
+    local indent_padding = string.rep(" ", indent_width)
+    local indent_string = indent_padding .. indent_markers.str
+    local line_nr = #self.lines - 1
+    self.virtual_lines[line_nr] = self.virtual_lines[line_nr] or {}
+
+    -- NOTE: We are inserting in depth order because of current traversal
+    -- if we change the traversal, we might need to sort by depth before rendering `self.virtual_lines`
+    -- to maintain proper ordering of parent and child folder hidden count info.
+    table.insert(self.virtual_lines[line_nr], {
+      { indent_string, indent_markers.hl },
+      { string.rep(indent_padding, (node.parent == nil and 0 or 1)) .. hidden_count_string, "NvimTreeHiddenDisplay" },
+    })
+  end
+end
+
+---@private
+function Builder:get_nodes_number(nodes)
+  if not self.explorer.live_filter.filter then
     return #nodes
   end
 
@@ -477,53 +418,115 @@ function Builder:_get_nodes_number(nodes)
   return i
 end
 
-function Builder:build(tree, unloaded_bufnr)
+---@private
-  local num_children = self:_get_nodes_number(tree.nodes)
+function Builder:build_lines(node)
+  if not node then
+    node = self.explorer
+  end
+  local num_children = self:get_nodes_number(node.nodes)
   local idx = 1
-  for _, node in ipairs(tree.nodes) do
+  for _, n in ipairs(node.nodes) do
-    if not node.hidden then
+    if not n.hidden then
-      self:_build_line(node, idx, num_children, unloaded_bufnr)
+      self:build_signs(n)
+      self:build_line(n, idx, num_children)
       idx = idx + 1
     end
   end
-
+  self:add_hidden_count_string(node)
-  return self
 end
 
-local function format_root_name(root_cwd, root_label)
+---@private
+---@param root_label function|string
+---@return string
+function Builder:format_root_name(root_label)
   if type(root_label) == "function" then
-    local label = root_label(root_cwd)
+    local label = root_label(self.explorer.absolute_path)
     if type(label) == "string" then
       return label
-    else
-      root_label = DEFAULT_ROOT_FOLDER_LABEL
     end
+  elseif type(root_label) == "string" then
+    return utils.path_remove_trailing(vim.fn.fnamemodify(self.explorer.absolute_path, root_label))
   end
-  return utils.path_remove_trailing(vim.fn.fnamemodify(root_cwd, root_label))
+  return "???"
 end
 
-function Builder:build_header(show_header)
+---@private
-  if show_header then
+function Builder:build_header()
-    local root_name = format_root_name(self.root_cwd, self.root_folder_label)
+  if view.is_root_folder_visible(self.explorer.absolute_path) then
-    self:_insert_line(root_name)
+    local root_name = self:format_root_name(self.opts.renderer.root_folder_label)
-    self:_insert_highlight({ "NvimTreeRootFolder" }, 0, string.len(root_name))
+    table.insert(self.lines, root_name)
+    self:insert_highlight({ "NvimTreeRootFolder" }, 0, string.len(root_name))
     self.index = 1
   end
 
-  if self.filter then
+  if self.explorer.live_filter.filter then
-    local filter_line = self.filter_prefix .. "/" .. self.filter .. "/"
+    local filter_line = string.format("%s/%s/", self.opts.live_filter.prefix, self.explorer.live_filter.filter)
-    self:_insert_line(filter_line)
+    table.insert(self.lines, filter_line)
-    local prefix_length = string.len(self.filter_prefix)
+    local prefix_length = string.len(self.opts.live_filter.prefix)
-    self:_insert_highlight({ "NvimTreeLiveFilterPrefix" }, 0, prefix_length)
+    self:insert_highlight({ "NvimTreeLiveFilterPrefix" }, 0, prefix_length)
-    self:_insert_highlight({ "NvimTreeLiveFilterValue" }, prefix_length, string.len(filter_line))
+    self:insert_highlight({ "NvimTreeLiveFilterValue" }, prefix_length, string.len(filter_line))
     self.index = self.index + 1
   end
+end
 
+---Sanitize lines for rendering.
+---Replace newlines with literal \n
+---@private
+function Builder:sanitize_lines()
+  self.lines = vim.tbl_map(function(line)
+    return line and line:gsub("\n", "\\n") or ""
+  end, self.lines)
+end
+
+---Build all lines with highlights and signs
+---@return Builder
+function Builder:build()
+  self:build_header()
+  self:build_lines()
+  self:sanitize_lines()
   return self
 end
 
-function Builder:unwrap()
+---TODO refactor back to function; this was left here to reduce PR noise
-  return self.lines, self.highlights, self.signs
+---@param opts table
+---@return fun(node: Node): string|nil
+function Builder:setup_hidden_display_function(opts)
+  local hidden_display = opts.renderer.hidden_display
+  -- options are already validated, so ´hidden_display´ can ONLY be `string` or `function` if type(hidden_display) == "string" then
+  if type(hidden_display) == "string" then
+    if hidden_display == "none" then
+      return function()
+        return nil
+      end
+    elseif hidden_display == "simple" then
+      return function(hidden_stats)
+        return utils.default_format_hidden_count(hidden_stats, true)
+      end
+    else -- "all"
+      return function(hidden_stats)
+        return utils.default_format_hidden_count(hidden_stats, false)
+      end
+    end
+  else -- "function
+    return function(hidden_stats)
+      -- In case of missing field such as live_filter we zero it, otherwise keep field as is
+      hidden_stats = vim.tbl_deep_extend("force", {
+        live_filter = 0,
+        git = 0,
+        buf = 0,
+        dotfile = 0,
+        custom = 0,
+        bookmark = 0,
+      }, hidden_stats or {})
+
+      local ok, result = pcall(hidden_display, hidden_stats)
+      if not ok then
+        notify.warn "Problem occurred in the function ``opts.renderer.hidden_display`` see nvim-tree.renderer.hidden_display on :h nvim-tree"
+        return nil
+      end
+      return result
+    end
+  end
 end
 
 return Builder

lua/nvim-tree/renderer/components/bookmarks.lua

@@ -1,51 +0,0 @@
-local marks = require "nvim-tree.marks"
-
-local HL_POSITION = require("nvim-tree.enum").HL_POSITION
-
-local M = {
-  ICON = {},
-  hl_pos = HL_POSITION.none,
-}
-
----Bookmark highlight group and position when highlight_bookmark.
----@param node table
----@return HL_POSITION position none when clipboard empty
----@return string|nil group only when node present in clipboard
-function M.get_highlight(node)
-  if M.hl_pos == HL_POSITION.none then
-    return HL_POSITION.none, nil
-  end
-
-  local mark = marks.get_mark(node)
-  if mark then
-    return M.hl_pos, "NvimTreeBookmarkHL"
-  else
-    return HL_POSITION.none, nil
-  end
-end
-
----bookmark icon if marked
----@param node table
----@return HighlightedString|nil bookmark icon
-function M.get_icon(node)
-  if M.config.renderer.icons.show.bookmarks and marks.get_mark(node) then
-    return M.ICON
-  end
-end
-
-function M.setup(opts)
-  M.config = {
-    renderer = opts.renderer,
-  }
-
-  M.hl_pos = HL_POSITION[opts.renderer.highlight_bookmarks] or HL_POSITION.none
-
-  M.ICON = {
-    str = opts.renderer.icons.glyphs.bookmark,
-    hl = { "NvimTreeBookmark" },
-  }
-
-  vim.fn.sign_define(M.ICON.hl[1], { text = M.ICON.str, texthl = M.ICON.hl[1] })
-end
-
-return M

lua/nvim-tree/renderer/components/diagnostics.lua

@@ -1,30 +1,37 @@
 local HL_POSITION = require("nvim-tree.enum").HL_POSITION
+local diagnostics = require "nvim-tree.diagnostics"
 
 local M = {
-  HS_FILE = {},
+  -- highlight strings for the icons
-  HS_FOLDER = {},
+  HS_ICON = {},
-  ICON = {},
+
-  hl_pos = HL_POSITION.none,
+  -- highlight groups for HL
+  HG_FILE = {},
+  HG_FOLDER = {},
+
+  -- position for HL
+  HL_POS = HL_POSITION.none,
 }
 
----Diagnostics text highlight group when highlight_diagnostics.
+---Diagnostics highlight group and position when highlight_diagnostics.
 ---@param node table
 ---@return HL_POSITION position none when no status
 ---@return string|nil group only when status
 function M.get_highlight(node)
-  if not node or M.hl_pos == HL_POSITION.none then
+  if not node or M.HL_POS == HL_POSITION.none then
     return HL_POSITION.none, nil
   end
 
   local group
+  local diag_status = diagnostics.get_diag_status(node)
   if node.nodes then
-    group = M.HS_FOLDER[node.diag_status]
+    group = M.HS_FOLDER[diag_status and diag_status.value]
   else
-    group = M.HS_FILE[node.diag_status]
+    group = M.HS_FILE[diag_status and diag_status.value]
   end
 
   if group then
-    return M.hl_pos, group
+    return M.HL_POS, group
   else
     return HL_POSITION.none, nil
   end
@@ -35,7 +42,8 @@ end
 ---@return HighlightedString|nil modified icon
 function M.get_icon(node)
   if node and M.config.diagnostics.enable and M.config.renderer.icons.show.diagnostics then
-    return M.ICON[node.diag_status]
+    local diag_status = diagnostics.get_diag_status(node)
+    return M.ICON[diag_status and diag_status.value]
   end
 end
 
@@ -46,40 +54,38 @@ function M.setup(opts)
   }
 
   if opts.diagnostics.enable and opts.renderer.highlight_diagnostics then
-    -- TODO add a HL_POSITION
+    M.HL_POS = HL_POSITION[opts.renderer.highlight_diagnostics]
-    -- M.hl_pos = HL_POSITION[opts.renderer.highlight_diagnostics]
-    M.hl_pos = HL_POSITION.name
   end
 
-  M.HS_FILE[vim.diagnostic.severity.ERROR] = "NvimTreeLspDiagnosticsErrorText"
+  M.HG_FILE[vim.diagnostic.severity.ERROR] = "NvimTreeDiagnosticErrorFileHL"
-  M.HS_FILE[vim.diagnostic.severity.WARN] = "NvimTreeLspDiagnosticsWarningText"
+  M.HG_FILE[vim.diagnostic.severity.WARN] = "NvimTreeDiagnosticWarningFileHL"
-  M.HS_FILE[vim.diagnostic.severity.INFO] = "NvimTreeLspDiagnosticsInfoText"
+  M.HG_FILE[vim.diagnostic.severity.INFO] = "NvimTreeDiagnosticInfoFileHL"
-  M.HS_FILE[vim.diagnostic.severity.HINT] = "NvimTreeLspDiagnosticsHintText"
+  M.HG_FILE[vim.diagnostic.severity.HINT] = "NvimTreeDiagnosticHintFileHL"
 
-  M.HS_FOLDER[vim.diagnostic.severity.ERROR] = "NvimTreeLspDiagnosticsErrorFolderText"
+  M.HG_FOLDER[vim.diagnostic.severity.ERROR] = "NvimTreeDiagnosticErrorFolderHL"
-  M.HS_FOLDER[vim.diagnostic.severity.WARN] = "NvimTreeLspDiagnosticsWarningFolderText"
+  M.HG_FOLDER[vim.diagnostic.severity.WARN] = "NvimTreeDiagnosticWarningFolderHL"
-  M.HS_FOLDER[vim.diagnostic.severity.INFO] = "NvimTreeLspDiagnosticsInfoFolderText"
+  M.HG_FOLDER[vim.diagnostic.severity.INFO] = "NvimTreeDiagnosticInfoFolderHL"
-  M.HS_FOLDER[vim.diagnostic.severity.HINT] = "NvimTreeLspDiagnosticsHintFolderText"
+  M.HG_FOLDER[vim.diagnostic.severity.HINT] = "NvimTreeDiagnosticHintFolderHL"
 
-  M.ICON[vim.diagnostic.severity.ERROR] = {
+  M.HS_ICON[vim.diagnostic.severity.ERROR] = {
     str = M.config.diagnostics.icons.error,
-    hl = { "NvimTreeLspDiagnosticsError" },
+    hl = { "NvimTreeDiagnosticErrorIcon" },
   }
 
-  M.ICON[vim.diagnostic.severity.WARN] = {
+  M.HS_ICON[vim.diagnostic.severity.WARN] = {
     str = M.config.diagnostics.icons.warning,
-    hl = { "NvimTreeLspDiagnosticsWarning" },
+    hl = { "NvimTreeDiagnosticWarningIcon" },
   }
-  M.ICON[vim.diagnostic.severity.INFO] = {
+  M.HS_ICON[vim.diagnostic.severity.INFO] = {
     str = M.config.diagnostics.icons.info,
-    hl = { "NvimTreeLspDiagnosticsInformation" },
+    hl = { "NvimTreeDiagnosticInfoIcon" },
   }
-  M.ICON[vim.diagnostic.severity.HINT] = {
+  M.HS_ICON[vim.diagnostic.severity.HINT] = {
     str = M.config.diagnostics.icons.hint,
-    hl = { "NvimTreeLspDiagnosticsHint" },
+    hl = { "NvimTreeDiagnosticHintIcon" },
   }
 
-  for _, i in ipairs(M.ICON) do
+  for _, i in ipairs(M.HS_ICON) do
     vim.fn.sign_define(i.hl[1], { text = i.str, texthl = i.hl[1] })
   end
 end

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

@@ -57,9 +57,9 @@ local function show()
   end
 
   M.popup_win = vim.api.nvim_open_win(vim.api.nvim_create_buf(false, false), false, {
-    relative = "cursor",
+    relative = "win",
     row = 0,
-    col = 1 - vim.fn.getcursorcharpos()[3],
+    bufpos = { vim.api.nvim_win_get_cursor(0)[1] - 1, 0 },
     width = math.min(text_width, vim.o.columns - 2),
     height = 1,
     noautocmd = true,
@@ -67,12 +67,19 @@ local function show()
   })
 
   local ns_id = vim.api.nvim_get_namespaces()["NvimTreeHighlights"]
-  local extmarks = vim.api.nvim_buf_get_extmarks(0, ns_id, { line_nr - 1, 0 }, { line_nr - 1, -1 }, { details = 1 })
+  local extmarks = vim.api.nvim_buf_get_extmarks(0, ns_id, { line_nr - 1, 0 }, { line_nr - 1, -1 }, { details = true })
   vim.api.nvim_win_call(M.popup_win, function()
     vim.api.nvim_buf_set_lines(0, 0, -1, true, { line })
     for _, extmark in ipairs(extmarks) do
-      local hl = extmark[4]
+      -- nvim 0.10 luadoc is incorrect: vim.api.keyset.get_extmark_item is missing the extmark_id at the start
-      vim.api.nvim_buf_add_highlight(0, ns_id, hl.hl_group, 0, extmark[3], hl.end_col)
+
+      ---@cast extmark table
+      ---@type integer
+      local col = extmark[3]
+      ---@type vim.api.keyset.extmark_details
+      local details = extmark[4]
+
+      vim.api.nvim_buf_add_highlight(0, ns_id, details.hl_group, 0, col, details.end_col)
     end
     vim.cmd [[ setlocal nowrap cursorline noswapfile nobuflisted buftype=nofile bufhidden=hide ]]
   end)

lua/nvim-tree/renderer/components/git.lua

@@ -1,191 +0,0 @@
-local notify = require "nvim-tree.notify"
-local explorer_node = require "nvim-tree.explorer.node"
-
-local M = {}
-
-local function build_icons_table(i)
-  local icons = {
-    staged = { str = i.staged, hl = { "NvimTreeGitStaged" }, ord = 1 },
-    unstaged = { str = i.unstaged, hl = { "NvimTreeGitDirty" }, ord = 2 },
-    renamed = { str = i.renamed, hl = { "NvimTreeGitRenamed" }, ord = 3 },
-    deleted = { str = i.deleted, hl = { "NvimTreeGitDeleted" }, ord = 4 },
-    unmerged = { str = i.unmerged, hl = { "NvimTreeGitMerge" }, ord = 5 },
-    untracked = { str = i.untracked, hl = { "NvimTreeGitNew" }, ord = 6 },
-    ignored = { str = i.ignored, hl = { "NvimTreeGitIgnored" }, ord = 7 },
-  }
-  return {
-    ["M "] = { icons.staged },
-    [" M"] = { icons.unstaged },
-    ["C "] = { icons.staged },
-    [" C"] = { icons.unstaged },
-    ["CM"] = { icons.unstaged },
-    [" T"] = { icons.unstaged },
-    ["T "] = { icons.staged },
-    ["TM"] = { icons.staged, icons.unstaged },
-    ["MM"] = { icons.staged, icons.unstaged },
-    ["MD"] = { icons.staged },
-    ["A "] = { icons.staged },
-    ["AD"] = { icons.staged },
-    [" A"] = { icons.untracked },
-    -- not sure about this one
-    ["AA"] = { icons.unmerged, icons.untracked },
-    ["AU"] = { icons.unmerged, icons.untracked },
-    ["AM"] = { icons.staged, icons.unstaged },
-    ["??"] = { icons.untracked },
-    ["R "] = { icons.renamed },
-    [" R"] = { icons.renamed },
-    ["RM"] = { icons.unstaged, icons.renamed },
-    ["UU"] = { icons.unmerged },
-    ["UD"] = { icons.unmerged },
-    ["UA"] = { icons.unmerged },
-    [" D"] = { icons.deleted },
-    ["D "] = { icons.deleted },
-    ["DA"] = { icons.unstaged },
-    ["RD"] = { icons.deleted },
-    ["DD"] = { icons.deleted },
-    ["DU"] = { icons.deleted, icons.unmerged },
-    ["!!"] = { icons.ignored },
-    dirty = { icons.unstaged },
-  }
-end
-
-local function build_hl_table()
-  local file = {
-    ["M "] = "NvimTreeFileStaged",
-    ["C "] = "NvimTreeFileStaged",
-    ["AA"] = "NvimTreeFileStaged",
-    ["AD"] = "NvimTreeFileStaged",
-    ["MD"] = "NvimTreeFileStaged",
-    ["T "] = "NvimTreeFileStaged",
-    ["TT"] = "NvimTreeFileStaged",
-    [" M"] = "NvimTreeFileDirty",
-    ["CM"] = "NvimTreeFileDirty",
-    [" C"] = "NvimTreeFileDirty",
-    [" T"] = "NvimTreeFileDirty",
-    ["MM"] = "NvimTreeFileDirty",
-    ["AM"] = "NvimTreeFileDirty",
-    dirty = "NvimTreeFileDirty",
-    ["A "] = "NvimTreeFileStaged",
-    ["??"] = "NvimTreeFileNew",
-    ["AU"] = "NvimTreeFileMerge",
-    ["UU"] = "NvimTreeFileMerge",
-    ["UD"] = "NvimTreeFileMerge",
-    ["DU"] = "NvimTreeFileMerge",
-    ["UA"] = "NvimTreeFileMerge",
-    [" D"] = "NvimTreeFileDeleted",
-    ["DD"] = "NvimTreeFileDeleted",
-    ["RD"] = "NvimTreeFileDeleted",
-    ["D "] = "NvimTreeFileDeleted",
-    ["R "] = "NvimTreeFileRenamed",
-    ["RM"] = "NvimTreeFileRenamed",
-    [" R"] = "NvimTreeFileRenamed",
-    ["!!"] = "NvimTreeFileIgnored",
-    [" A"] = "none",
-  }
-
-  local folder = {}
-  for k, v in pairs(file) do
-    folder[k] = v:gsub("File", "Folder")
-  end
-
-  return file, folder
-end
-
-local function nil_() end
-
-local function warn_status(git_status)
-  notify.warn(string.format("Unrecognized git state '%s'", git_status))
-end
-
----@param node table
----@return HighlightedString[]|nil
-local function get_icons_(node)
-  local git_status = explorer_node.get_git_status(node)
-  if git_status == nil then
-    return nil
-  end
-
-  local inserted = {}
-  local iconss = {}
-
-  for _, s in pairs(git_status) do
-    local icons = M.git_icons[s]
-    if not icons then
-      if not M.config.highlight_git then
-        warn_status(s)
-      end
-      return nil
-    end
-
-    for _, icon in pairs(icons) do
-      if #icon.str > 0 then
-        if not inserted[icon] then
-          table.insert(iconss, icon)
-          inserted[icon] = true
-        end
-      end
-    end
-  end
-
-  if #iconss == 0 then
-    return nil
-  end
-
-  -- sort icons so it looks slightly better
-  table.sort(iconss, function(a, b)
-    return a.ord < b.ord
-  end)
-
-  return iconss
-end
-
-function M.setup_signs(i)
-  vim.fn.sign_define("NvimTreeGitDirty", { text = i.unstaged, texthl = "NvimTreeGitDirty" })
-  vim.fn.sign_define("NvimTreeGitStaged", { text = i.staged, texthl = "NvimTreeGitStaged" })
-  vim.fn.sign_define("NvimTreeGitMerge", { text = i.unmerged, texthl = "NvimTreeGitMerge" })
-  vim.fn.sign_define("NvimTreeGitRenamed", { text = i.renamed, texthl = "NvimTreeGitRenamed" })
-  vim.fn.sign_define("NvimTreeGitNew", { text = i.untracked, texthl = "NvimTreeGitNew" })
-  vim.fn.sign_define("NvimTreeGitDeleted", { text = i.deleted, texthl = "NvimTreeGitDeleted" })
-  vim.fn.sign_define("NvimTreeGitIgnored", { text = i.ignored, texthl = "NvimTreeGitIgnored" })
-end
-
-local function get_highlight_(node)
-  local git_status = explorer_node.get_git_status(node)
-  if git_status == nil then
-    return
-  end
-
-  if node.nodes then
-    return M.folder_hl[git_status[1]]
-  else
-    return M.file_hl[git_status[1]]
-  end
-end
-
-function M.setup(opts)
-  M.config = opts.renderer
-
-  M.git_icons = build_icons_table(opts.renderer.icons.glyphs.git)
-
-  M.file_hl, M.folder_hl = build_hl_table()
-
-  if opts.renderer.icons.git_placement == "signcolumn" then
-    M.setup_signs(opts.renderer.icons.glyphs.git)
-  end
-
-  if opts.renderer.icons.show.git then
-    M.get_icons = get_icons_
-  else
-    M.get_icons = nil_
-  end
-
-  if opts.renderer.highlight_git then
-    M.get_highlight = get_highlight_
-  else
-    M.get_highlight = nil_
-  end
-
-  M.git_show_on_open_dirs = opts.git.show_on_open_dirs
-end
-
-return M

lua/nvim-tree/renderer/components/icons.lua

@@ -65,7 +65,12 @@ local function get_file_icon_webdev(fname, extension)
     -- If there are more extensions to the file, try to grab the icon for them recursively
     return get_file_icon_webdev(fname, string.match(extension, "%.(.*)"))
   else
-    return get_file_icon_default()
+    local devicons_default = M.devicons.get_default_icon()
+    if devicons_default and type(devicons_default.icon) == "string" and type(devicons_default.name) == "string" then
+      return devicons_default.icon, "DevIcon" .. devicons_default.name
+    else
+      return get_file_icon_default()
+    end
   end
 end
 

lua/nvim-tree/renderer/components/init.lua

@@ -0,0 +1,15 @@
+local M = {}
+
+M.diagnostics = require "nvim-tree.renderer.components.diagnostics"
+M.full_name = require "nvim-tree.renderer.components.full-name"
+M.icons = require "nvim-tree.renderer.components.icons"
+M.padding = require "nvim-tree.renderer.components.padding"
+
+function M.setup(opts)
+  M.diagnostics.setup(opts)
+  M.full_name.setup(opts)
+  M.icons.setup(opts)
+  M.padding.setup(opts)
+end
+
+return M

lua/nvim-tree/renderer/components/modified.lua

@@ -1,41 +0,0 @@
-local modified = require "nvim-tree.modified"
-
-local M = {}
-
-local HIGHLIGHT = "NvimTreeModifiedFile"
-
----return modified icon if node is modified, otherwise return empty string
----@param node table
----@return HighlightedString|nil modified icon
-function M.get_icon(node)
-  if not modified.is_modified(node) or not M.show_icon then
-    return nil
-  end
-
-  return { str = M.icon, hl = { HIGHLIGHT } }
-end
-
-function M.setup_signs()
-  vim.fn.sign_define(HIGHLIGHT, { text = M.icon, texthl = HIGHLIGHT })
-end
-
----@param node table
----@return string|nil
-function M.get_highlight(node)
-  if not modified.is_modified(node) then
-    return nil
-  end
-
-  return HIGHLIGHT
-end
-
-function M.setup(opts)
-  M.icon = opts.renderer.icons.glyphs.modified
-  M.show_icon = opts.renderer.icons.show.modified
-
-  if opts.renderer.icons.modified_placement == "signcolumn" then
-    M.setup_signs()
-  end
-end
-
-return M

lua/nvim-tree/renderer/components/padding.lua

@@ -19,7 +19,7 @@ local function check_siblings_for_folder(node, with_arrows)
   return false
 end
 
-local function get_padding_indent_markers(depth, idx, nodes_number, markers, with_arrows, inline_arrows, node)
+local function get_padding_indent_markers(depth, idx, nodes_number, markers, with_arrows, inline_arrows, node, early_stop)
   local base_padding = with_arrows and (not node.nodes or depth > 0) and "  " or ""
   local padding = (inline_arrows or depth == 0) and base_padding or ""
 
@@ -27,7 +27,7 @@ local function get_padding_indent_markers(depth, idx, nodes_number, markers, wit
     local has_folder_sibling = check_siblings_for_folder(node, with_arrows)
     local indent = string.rep(" ", M.config.indent_width - 1)
     markers[depth] = idx ~= nodes_number
-    for i = 1, depth do
+    for i = 1, depth - early_stop do
       local glyph
       if idx == nodes_number and i == depth then
         local bottom_width = M.config.indent_width - 2 + (with_arrows and not inline_arrows and has_folder_sibling and 2 or 0)
@@ -62,7 +62,7 @@ end
 ---@param node table
 ---@param markers table
 ---@return HighlightedString[]
-function M.get_indent_markers(depth, idx, nodes_number, node, markers)
+function M.get_indent_markers(depth, idx, nodes_number, node, markers, early_stop)
   local str = ""
 
   local show_arrows = M.config.icons.show.folder_arrow
@@ -71,7 +71,7 @@ function M.get_indent_markers(depth, idx, nodes_number, node, markers)
   local indent_width = M.config.indent_width
 
   if show_markers then
-    str = str .. get_padding_indent_markers(depth, idx, nodes_number, markers, show_arrows, inline_arrows, node)
+    str = str .. get_padding_indent_markers(depth, idx, nodes_number, markers, show_arrows, inline_arrows, node, early_stop or 0)
   else
     str = str .. string.rep(" ", depth * indent_width)
   end

lua/nvim-tree/renderer/decorator/bookmarks.lua

@@ -0,0 +1,51 @@
+local HL_POSITION = require("nvim-tree.enum").HL_POSITION
+local ICON_PLACEMENT = require("nvim-tree.enum").ICON_PLACEMENT
+
+local Decorator = require "nvim-tree.renderer.decorator"
+
+---@class (exact) DecoratorBookmarks: Decorator
+---@field icon HighlightedString
+local DecoratorBookmarks = Decorator:new()
+
+---@param opts table
+---@param explorer Explorer
+---@return DecoratorBookmarks
+function DecoratorBookmarks:new(opts, explorer)
+  local o = Decorator.new(self, {
+    explorer = explorer,
+    enabled = true,
+    hl_pos = HL_POSITION[opts.renderer.highlight_bookmarks] or HL_POSITION.none,
+    icon_placement = ICON_PLACEMENT[opts.renderer.icons.bookmarks_placement] or ICON_PLACEMENT.none,
+  })
+  ---@cast o DecoratorBookmarks
+
+  if opts.renderer.icons.show.bookmarks then
+    o.icon = {
+      str = opts.renderer.icons.glyphs.bookmark,
+      hl = { "NvimTreeBookmarkIcon" },
+    }
+    o:define_sign(o.icon)
+  end
+
+  return o
+end
+
+---Bookmark icon: renderer.icons.show.bookmarks and node is marked
+---@param node Node
+---@return HighlightedString[]|nil icons
+function DecoratorBookmarks:calculate_icons(node)
+  if self.explorer.marks:get(node) then
+    return { self.icon }
+  end
+end
+
+---Bookmark highlight: renderer.highlight_bookmarks and node is marked
+---@param node Node
+---@return string|nil group
+function DecoratorBookmarks:calculate_highlight(node)
+  if self.hl_pos ~= HL_POSITION.none and self.explorer.marks:get(node) then
+    return "NvimTreeBookmarkHL"
+  end
+end
+
+return DecoratorBookmarks

lua/nvim-tree/renderer/decorator/copied.lua

@@ -0,0 +1,35 @@
+local HL_POSITION = require("nvim-tree.enum").HL_POSITION
+local ICON_PLACEMENT = require("nvim-tree.enum").ICON_PLACEMENT
+
+local Decorator = require "nvim-tree.renderer.decorator"
+
+---@class (exact) DecoratorCopied: Decorator
+---@field enabled boolean
+---@field icon HighlightedString|nil
+local DecoratorCopied = Decorator:new()
+
+---@param opts table
+---@param explorer Explorer
+---@return DecoratorCopied
+function DecoratorCopied:new(opts, explorer)
+  local o = Decorator.new(self, {
+    explorer = explorer,
+    enabled = true,
+    hl_pos = HL_POSITION[opts.renderer.highlight_clipboard] or HL_POSITION.none,
+    icon_placement = ICON_PLACEMENT.none,
+  })
+  ---@cast o DecoratorCopied
+
+  return o
+end
+
+---Copied highlight: renderer.highlight_clipboard and node is copied
+---@param node Node
+---@return string|nil group
+function DecoratorCopied:calculate_highlight(node)
+  if self.hl_pos ~= HL_POSITION.none and self.explorer.clipboard:is_copied(node) then
+    return "NvimTreeCopiedHL"
+  end
+end
+
+return DecoratorCopied

lua/nvim-tree/renderer/decorator/cut.lua

@@ -0,0 +1,35 @@
+local HL_POSITION = require("nvim-tree.enum").HL_POSITION
+local ICON_PLACEMENT = require("nvim-tree.enum").ICON_PLACEMENT
+
+local Decorator = require "nvim-tree.renderer.decorator"
+
+---@class (exact) DecoratorCut: Decorator
+---@field enabled boolean
+---@field icon HighlightedString|nil
+local DecoratorCut = Decorator:new()
+
+---@param opts table
+---@param explorer Explorer
+---@return DecoratorCut
+function DecoratorCut:new(opts, explorer)
+  local o = Decorator.new(self, {
+    explorer = explorer,
+    enabled = true,
+    hl_pos = HL_POSITION[opts.renderer.highlight_clipboard] or HL_POSITION.none,
+    icon_placement = ICON_PLACEMENT.none,
+  })
+  ---@cast o DecoratorCut
+
+  return o
+end
+
+---Cut highlight: renderer.highlight_clipboard and node is cut
+---@param node Node
+---@return string|nil group
+function DecoratorCut:calculate_highlight(node)
+  if self.hl_pos ~= HL_POSITION.none and self.explorer.clipboard:is_cut(node) then
+    return "NvimTreeCutHL"
+  end
+end
+
+return DecoratorCut

lua/nvim-tree/renderer/decorator/diagnostics.lua

@@ -0,0 +1,112 @@
+local diagnostics = require "nvim-tree.diagnostics"
+
+local HL_POSITION = require("nvim-tree.enum").HL_POSITION
+local ICON_PLACEMENT = require("nvim-tree.enum").ICON_PLACEMENT
+
+local Decorator = require "nvim-tree.renderer.decorator"
+
+-- highlight groups by severity
+local HG_ICON = {
+  [vim.diagnostic.severity.ERROR] = "NvimTreeDiagnosticErrorIcon",
+  [vim.diagnostic.severity.WARN] = "NvimTreeDiagnosticWarnIcon",
+  [vim.diagnostic.severity.INFO] = "NvimTreeDiagnosticInfoIcon",
+  [vim.diagnostic.severity.HINT] = "NvimTreeDiagnosticHintIcon",
+}
+local HG_FILE = {
+  [vim.diagnostic.severity.ERROR] = "NvimTreeDiagnosticErrorFileHL",
+  [vim.diagnostic.severity.WARN] = "NvimTreeDiagnosticWarnFileHL",
+  [vim.diagnostic.severity.INFO] = "NvimTreeDiagnosticInfoFileHL",
+  [vim.diagnostic.severity.HINT] = "NvimTreeDiagnosticHintFileHL",
+}
+local HG_FOLDER = {
+  [vim.diagnostic.severity.ERROR] = "NvimTreeDiagnosticErrorFolderHL",
+  [vim.diagnostic.severity.WARN] = "NvimTreeDiagnosticWarnFolderHL",
+  [vim.diagnostic.severity.INFO] = "NvimTreeDiagnosticInfoFolderHL",
+  [vim.diagnostic.severity.HINT] = "NvimTreeDiagnosticHintFolderHL",
+}
+-- opts.diagnostics.icons.
+local ICON_KEYS = {
+  ["error"] = vim.diagnostic.severity.ERROR,
+  ["warning"] = vim.diagnostic.severity.WARN,
+  ["info"] = vim.diagnostic.severity.INFO,
+  ["hint"] = vim.diagnostic.severity.HINT,
+}
+
+---@class (exact) DecoratorDiagnostics: Decorator
+---@field icons HighlightedString[]
+local DecoratorDiagnostics = Decorator:new()
+
+---@param opts table
+---@param explorer Explorer
+---@return DecoratorDiagnostics
+function DecoratorDiagnostics:new(opts, explorer)
+  local o = Decorator.new(self, {
+    explorer = explorer,
+    enabled = opts.diagnostics.enable,
+    hl_pos = HL_POSITION[opts.renderer.highlight_diagnostics] or HL_POSITION.none,
+    icon_placement = ICON_PLACEMENT[opts.renderer.icons.diagnostics_placement] or ICON_PLACEMENT.none,
+  })
+  ---@cast o DecoratorDiagnostics
+
+  if not o.enabled then
+    return o
+  end
+
+  if opts.renderer.icons.show.diagnostics then
+    o.icons = {}
+    for name, sev in pairs(ICON_KEYS) do
+      o.icons[sev] = {
+        str = opts.diagnostics.icons[name],
+        hl = { HG_ICON[sev] },
+      }
+      o:define_sign(o.icons[sev])
+    end
+  end
+
+  return o
+end
+
+---Diagnostic icon: diagnostics.enable, renderer.icons.show.diagnostics and node has status
+---@param node Node
+---@return HighlightedString[]|nil icons
+function DecoratorDiagnostics:calculate_icons(node)
+  if node and self.enabled and self.icons then
+    local diag_status = diagnostics.get_diag_status(node)
+    local diag_value = diag_status and diag_status.value
+
+    if diag_value then
+      return { self.icons[diag_value] }
+    end
+  end
+end
+
+---Diagnostic highlight: diagnostics.enable, renderer.highlight_diagnostics and node has status
+---@param node Node
+---@return string|nil group
+function DecoratorDiagnostics:calculate_highlight(node)
+  if not node or not self.enabled or self.hl_pos == HL_POSITION.none then
+    return nil
+  end
+
+  local diag_status = diagnostics.get_diag_status(node)
+  local diag_value = diag_status and diag_status.value
+
+  if not diag_value then
+    return nil
+  end
+
+  local group
+  if node.nodes then
+    group = HG_FOLDER[diag_value]
+  else
+    group = HG_FILE[diag_value]
+  end
+
+  if group then
+    return group
+  else
+    return nil
+  end
+end
+
+return DecoratorDiagnostics

lua/nvim-tree/renderer/decorator/git.lua

@@ -0,0 +1,223 @@
+local notify = require "nvim-tree.notify"
+local explorer_node = require "nvim-tree.explorer.node"
+
+local HL_POSITION = require("nvim-tree.enum").HL_POSITION
+local ICON_PLACEMENT = require("nvim-tree.enum").ICON_PLACEMENT
+
+local Decorator = require "nvim-tree.renderer.decorator"
+
+---@class HighlightedStringGit: HighlightedString
+---@field ord number decreasing priority
+
+---@class (exact) DecoratorGit: Decorator
+---@field file_hl table<string, string> by porcelain status e.g. "AM"
+---@field folder_hl table<string, string> by porcelain status
+---@field icons_by_status HighlightedStringGit[] by human status
+---@field icons_by_xy table<string, HighlightedStringGit[]> by porcelain status
+local DecoratorGit = Decorator:new()
+
+---@param opts table
+---@param explorer Explorer
+---@return DecoratorGit
+function DecoratorGit:new(opts, explorer)
+  local o = Decorator.new(self, {
+    explorer = explorer,
+    enabled = opts.git.enable,
+    hl_pos = HL_POSITION[opts.renderer.highlight_git] or HL_POSITION.none,
+    icon_placement = ICON_PLACEMENT[opts.renderer.icons.git_placement] or ICON_PLACEMENT.none,
+  })
+  ---@cast o DecoratorGit
+
+  if not o.enabled then
+    return o
+  end
+
+  if o.hl_pos ~= HL_POSITION.none then
+    o:build_hl_table()
+  end
+
+  if opts.renderer.icons.show.git then
+    o:build_icons_by_status(opts.renderer.icons.glyphs.git)
+    o:build_icons_by_xy(o.icons_by_status)
+
+    for _, icon in pairs(o.icons_by_status) do
+      self:define_sign(icon)
+    end
+  end
+
+  return o
+end
+
+---@param glyphs table<string, string> user glyps
+function DecoratorGit:build_icons_by_status(glyphs)
+  self.icons_by_status = {
+    staged = { str = glyphs.staged, hl = { "NvimTreeGitStagedIcon" }, ord = 1 },
+    unstaged = { str = glyphs.unstaged, hl = { "NvimTreeGitDirtyIcon" }, ord = 2 },
+    renamed = { str = glyphs.renamed, hl = { "NvimTreeGitRenamedIcon" }, ord = 3 },
+    deleted = { str = glyphs.deleted, hl = { "NvimTreeGitDeletedIcon" }, ord = 4 },
+    unmerged = { str = glyphs.unmerged, hl = { "NvimTreeGitMergeIcon" }, ord = 5 },
+    untracked = { str = glyphs.untracked, hl = { "NvimTreeGitNewIcon" }, ord = 6 },
+    ignored = { str = glyphs.ignored, hl = { "NvimTreeGitIgnoredIcon" }, ord = 7 },
+  }
+end
+
+---@param icons HighlightedStringGit[]
+function DecoratorGit:build_icons_by_xy(icons)
+  self.icons_by_xy = {
+    ["M "] = { icons.staged },
+    [" M"] = { icons.unstaged },
+    ["C "] = { icons.staged },
+    [" C"] = { icons.unstaged },
+    ["CM"] = { icons.unstaged },
+    [" T"] = { icons.unstaged },
+    ["T "] = { icons.staged },
+    ["TM"] = { icons.staged, icons.unstaged },
+    ["MM"] = { icons.staged, icons.unstaged },
+    ["MD"] = { icons.staged },
+    ["A "] = { icons.staged },
+    ["AD"] = { icons.staged },
+    [" A"] = { icons.untracked },
+    -- not sure about this one
+    ["AA"] = { icons.unmerged, icons.untracked },
+    ["AU"] = { icons.unmerged, icons.untracked },
+    ["AM"] = { icons.staged, icons.unstaged },
+    ["??"] = { icons.untracked },
+    ["R "] = { icons.renamed },
+    [" R"] = { icons.renamed },
+    ["RM"] = { icons.unstaged, icons.renamed },
+    ["UU"] = { icons.unmerged },
+    ["UD"] = { icons.unmerged },
+    ["UA"] = { icons.unmerged },
+    [" D"] = { icons.deleted },
+    ["D "] = { icons.deleted },
+    ["DA"] = { icons.unstaged },
+    ["RD"] = { icons.deleted },
+    ["DD"] = { icons.deleted },
+    ["DU"] = { icons.deleted, icons.unmerged },
+    ["!!"] = { icons.ignored },
+    dirty = { icons.unstaged },
+  }
+end
+
+function DecoratorGit:build_hl_table()
+  self.file_hl = {
+    ["M "] = "NvimTreeGitFileStagedHL",
+    ["C "] = "NvimTreeGitFileStagedHL",
+    ["AA"] = "NvimTreeGitFileStagedHL",
+    ["AD"] = "NvimTreeGitFileStagedHL",
+    ["MD"] = "NvimTreeGitFileStagedHL",
+    ["T "] = "NvimTreeGitFileStagedHL",
+    ["TT"] = "NvimTreeGitFileStagedHL",
+    [" M"] = "NvimTreeGitFileDirtyHL",
+    ["CM"] = "NvimTreeGitFileDirtyHL",
+    [" C"] = "NvimTreeGitFileDirtyHL",
+    [" T"] = "NvimTreeGitFileDirtyHL",
+    ["MM"] = "NvimTreeGitFileDirtyHL",
+    ["AM"] = "NvimTreeGitFileDirtyHL",
+    dirty = "NvimTreeGitFileDirtyHL",
+    ["A "] = "NvimTreeGitFileStagedHL",
+    ["??"] = "NvimTreeGitFileNewHL",
+    ["AU"] = "NvimTreeGitFileMergeHL",
+    ["UU"] = "NvimTreeGitFileMergeHL",
+    ["UD"] = "NvimTreeGitFileMergeHL",
+    ["DU"] = "NvimTreeGitFileMergeHL",
+    ["UA"] = "NvimTreeGitFileMergeHL",
+    [" D"] = "NvimTreeGitFileDeletedHL",
+    ["DD"] = "NvimTreeGitFileDeletedHL",
+    ["RD"] = "NvimTreeGitFileDeletedHL",
+    ["D "] = "NvimTreeGitFileDeletedHL",
+    ["R "] = "NvimTreeGitFileRenamedHL",
+    ["RM"] = "NvimTreeGitFileRenamedHL",
+    [" R"] = "NvimTreeGitFileRenamedHL",
+    ["!!"] = "NvimTreeGitFileIgnoredHL",
+    [" A"] = "none",
+  }
+
+  self.folder_hl = {}
+  for k, v in pairs(self.file_hl) do
+    self.folder_hl[k] = v:gsub("File", "Folder")
+  end
+end
+
+---Git icons: git.enable, renderer.icons.show.git and node has status
+---@param node Node
+---@return HighlightedString[]|nil modified icon
+function DecoratorGit:calculate_icons(node)
+  if not node or not self.enabled or not self.icons_by_xy then
+    return nil
+  end
+
+  local git_status = explorer_node.get_git_status(node)
+  if git_status == nil then
+    return nil
+  end
+
+  local inserted = {}
+  local iconss = {}
+
+  for _, s in pairs(git_status) do
+    local icons = self.icons_by_xy[s]
+    if not icons then
+      if self.hl_pos == HL_POSITION.none then
+        notify.warn(string.format("Unrecognized git state '%s'", git_status))
+      end
+      return nil
+    end
+
+    for _, icon in pairs(icons) do
+      if #icon.str > 0 then
+        if not inserted[icon] then
+          table.insert(iconss, icon)
+          inserted[icon] = true
+        end
+      end
+    end
+  end
+
+  if #iconss == 0 then
+    return nil
+  end
+
+  -- sort icons so it looks slightly better
+  table.sort(iconss, function(a, b)
+    return a.ord < b.ord
+  end)
+
+  return iconss
+end
+
+---Get the first icon as the sign if appropriate
+---@param node Node
+---@return string|nil name
+function DecoratorGit:sign_name(node)
+  if self.icon_placement ~= ICON_PLACEMENT.signcolumn then
+    return
+  end
+
+  local icons = self:calculate_icons(node)
+  if icons and #icons > 0 then
+    return icons[1].hl[1]
+  end
+end
+
+---Git highlight: git.enable, renderer.highlight_git and node has status
+---@param node Node
+---@return string|nil group
+function DecoratorGit:calculate_highlight(node)
+  if not node or not self.enabled or self.hl_pos == HL_POSITION.none then
+    return nil
+  end
+
+  local git_status = explorer_node.get_git_status(node)
+  if not git_status then
+    return nil
+  end
+
+  if node.nodes then
+    return self.folder_hl[git_status[1]]
+  else
+    return self.file_hl[git_status[1]]
+  end
+end
+
+return DecoratorGit

lua/nvim-tree/renderer/decorator/hidden.lua

@@ -0,0 +1,57 @@
+local HL_POSITION = require("nvim-tree.enum").HL_POSITION
+local ICON_PLACEMENT = require("nvim-tree.enum").ICON_PLACEMENT
+local explorer_node = require "nvim-tree.explorer.node"
+local Decorator = require "nvim-tree.renderer.decorator"
+
+---@class (exact) DecoratorHidden: Decorator
+---@field icon HighlightedString|nil
+local DecoratorHidden = Decorator:new()
+
+---@param opts table
+---@param explorer Explorer
+---@return DecoratorHidden
+function DecoratorHidden:new(opts, explorer)
+  local o = Decorator.new(self, {
+    explorer = explorer,
+    enabled = true,
+    hl_pos = HL_POSITION[opts.renderer.highlight_hidden] or HL_POSITION.none,
+    icon_placement = ICON_PLACEMENT[opts.renderer.icons.hidden_placement] or ICON_PLACEMENT.none,
+  })
+  ---@cast o DecoratorHidden
+
+  if opts.renderer.icons.show.hidden then
+    o.icon = {
+      str = opts.renderer.icons.glyphs.hidden,
+      hl = { "NvimTreeHiddenIcon" },
+    }
+    o:define_sign(o.icon)
+  end
+
+  return o
+end
+
+---Hidden icon: renderer.icons.show.hidden and node starts with `.` (dotfile).
+---@param node Node
+---@return HighlightedString[]|nil icons
+function DecoratorHidden:calculate_icons(node)
+  if self.enabled and explorer_node.is_dotfile(node) then
+    return { self.icon }
+  end
+end
+
+---Hidden highlight: renderer.highlight_hidden and node starts with `.` (dotfile).
+---@param node Node
+---@return string|nil group
+function DecoratorHidden:calculate_highlight(node)
+  if not self.enabled or self.hl_pos == HL_POSITION.none or (not explorer_node.is_dotfile(node)) then
+    return nil
+  end
+
+  if node.nodes then
+    return "NvimTreeHiddenFolderHL"
+  else
+    return "NvimTreeHiddenFileHL"
+  end
+end
+
+return DecoratorHidden

lua/nvim-tree/renderer/decorator/init.lua

@@ -0,0 +1,136 @@
+local HL_POSITION = require("nvim-tree.enum").HL_POSITION
+local ICON_PLACEMENT = require("nvim-tree.enum").ICON_PLACEMENT
+
+---@class (exact) Decorator
+---@field private __index? table
+---@field protected explorer Explorer
+---@field protected enabled boolean
+---@field protected hl_pos HL_POSITION
+---@field protected icon_placement ICON_PLACEMENT
+local Decorator = {}
+
+---@param o Decorator|nil
+---@return Decorator
+function Decorator:new(o)
+  o = o or {}
+
+  setmetatable(o, self)
+  self.__index = self
+
+  return o
+end
+
+---Maybe highlight groups
+---@param node Node
+---@return string|nil icon highlight group
+---@return string|nil name highlight group
+function Decorator:groups_icon_name(node)
+  local icon_hl, name_hl
+
+  if self.enabled and self.hl_pos ~= HL_POSITION.none then
+    local hl = self:calculate_highlight(node)
+
+    if self.hl_pos == HL_POSITION.all or self.hl_pos == HL_POSITION.icon then
+      icon_hl = hl
+    end
+    if self.hl_pos == HL_POSITION.all or self.hl_pos == HL_POSITION.name then
+      name_hl = hl
+    end
+  end
+
+  return icon_hl, name_hl
+end
+
+---Maybe icon sign
+---@param node Node
+---@return string|nil name
+function Decorator:sign_name(node)
+  if not self.enabled or self.icon_placement ~= ICON_PLACEMENT.signcolumn then
+    return
+  end
+
+  local icons = self:calculate_icons(node)
+  if icons and #icons > 0 then
+    return icons[1].hl[1]
+  end
+end
+
+---Icons when ICON_PLACEMENT.before
+---@param node Node
+---@return HighlightedString[]|nil icons
+function Decorator:icons_before(node)
+  if not self.enabled or self.icon_placement ~= ICON_PLACEMENT.before then
+    return
+  end
+
+  return self:calculate_icons(node)
+end
+
+---Icons when ICON_PLACEMENT.after
+---@param node Node
+---@return HighlightedString[]|nil icons
+function Decorator:icons_after(node)
+  if not self.enabled or self.icon_placement ~= ICON_PLACEMENT.after then
+    return
+  end
+
+  return self:calculate_icons(node)
+end
+
+---Icons when ICON_PLACEMENT.right_align
+---@param node Node
+---@return HighlightedString[]|nil icons
+function Decorator:icons_right_align(node)
+  if not self.enabled or self.icon_placement ~= ICON_PLACEMENT.right_align then
+    return
+  end
+
+  return self:calculate_icons(node)
+end
+
+---Maybe icons, optionally implemented
+---@protected
+---@param _ Node
+---@return HighlightedString[]|nil icons
+function Decorator:calculate_icons(_)
+  return nil
+end
+
+---Maybe highlight group, optionally implemented
+---@protected
+---@param _ Node
+---@return string|nil group
+function Decorator:calculate_highlight(_)
+  return nil
+end
+
+---Define a sign
+---@protected
+---@param icon HighlightedString|nil
+function Decorator:define_sign(icon)
+  if icon and #icon.hl > 0 then
+    local name = icon.hl[1]
+
+    if not vim.tbl_isempty(vim.fn.sign_getdefined(name)) then
+      vim.fn.sign_undefine(name)
+    end
+
+    -- don't use sign if not defined
+    if #icon.str < 1 then
+      self.icon_placement = ICON_PLACEMENT.none
+      return
+    end
+
+    -- byte index of the next character, allowing for wide
+    local bi = vim.fn.byteidx(icon.str, 1)
+
+    -- first (wide) character, falls back to empty string
+    local text = string.sub(icon.str, 1, bi)
+    vim.fn.sign_define(name, {
+      text = text,
+      texthl = name,
+    })
+  end
+end
+
+return Decorator

lua/nvim-tree/renderer/decorator/modified.lua

@@ -0,0 +1,63 @@
+local buffers = require "nvim-tree.buffers"
+
+local HL_POSITION = require("nvim-tree.enum").HL_POSITION
+local ICON_PLACEMENT = require("nvim-tree.enum").ICON_PLACEMENT
+
+local Decorator = require "nvim-tree.renderer.decorator"
+
+---@class (exact) DecoratorModified: Decorator
+---@field icon HighlightedString|nil
+local DecoratorModified = Decorator:new()
+
+---@param opts table
+---@param explorer Explorer
+---@return DecoratorModified
+function DecoratorModified:new(opts, explorer)
+  local o = Decorator.new(self, {
+    explorer = explorer,
+    enabled = opts.modified.enable,
+    hl_pos = HL_POSITION[opts.renderer.highlight_modified] or HL_POSITION.none,
+    icon_placement = ICON_PLACEMENT[opts.renderer.icons.modified_placement] or ICON_PLACEMENT.none,
+  })
+  ---@cast o DecoratorModified
+
+  if not o.enabled then
+    return o
+  end
+
+  if opts.renderer.icons.show.modified then
+    o.icon = {
+      str = opts.renderer.icons.glyphs.modified,
+      hl = { "NvimTreeModifiedIcon" },
+    }
+    o:define_sign(o.icon)
+  end
+
+  return o
+end
+
+---Modified icon: modified.enable, renderer.icons.show.modified and node is modified
+---@param node Node
+---@return HighlightedString[]|nil icons
+function DecoratorModified:calculate_icons(node)
+  if self.enabled and buffers.is_modified(node) then
+    return { self.icon }
+  end
+end
+
+---Modified highlight: modified.enable, renderer.highlight_modified and node is modified
+---@param node Node
+---@return string|nil group
+function DecoratorModified:calculate_highlight(node)
+  if not self.enabled or self.hl_pos == HL_POSITION.none or not buffers.is_modified(node) then
+    return nil
+  end
+
+  if node.nodes then
+    return "NvimTreeModifiedFolderHL"
+  else
+    return "NvimTreeModifiedFileHL"
+  end
+end
+
+return DecoratorModified

lua/nvim-tree/renderer/decorator/opened.lua

@@ -0,0 +1,37 @@
+local buffers = require "nvim-tree.buffers"
+
+local HL_POSITION = require("nvim-tree.enum").HL_POSITION
+local ICON_PLACEMENT = require("nvim-tree.enum").ICON_PLACEMENT
+
+local Decorator = require "nvim-tree.renderer.decorator"
+
+---@class (exact) DecoratorOpened: Decorator
+---@field enabled boolean
+---@field icon HighlightedString|nil
+local DecoratorOpened = Decorator:new()
+
+---@param opts table
+---@param explorer Explorer
+---@return DecoratorOpened
+function DecoratorOpened:new(opts, explorer)
+  local o = Decorator.new(self, {
+    explorer = explorer,
+    enabled = true,
+    hl_pos = HL_POSITION[opts.renderer.highlight_opened_files] or HL_POSITION.none,
+    icon_placement = ICON_PLACEMENT.none,
+  })
+  ---@cast o DecoratorOpened
+
+  return o
+end
+
+---Opened highlight: renderer.highlight_opened_files and node has an open buffer
+---@param node Node
+---@return string|nil group
+function DecoratorOpened:calculate_highlight(node)
+  if self.hl_pos ~= HL_POSITION.none and buffers.is_opened(node) then
+    return "NvimTreeOpenedHL"
+  end
+end
+
+return DecoratorOpened

lua/nvim-tree/renderer/init.lua

@@ -1,96 +1,120 @@
-local core = require "nvim-tree.core"
 local log = require "nvim-tree.log"
 local view = require "nvim-tree.view"
 local events = require "nvim-tree.events"
-local modified = require "nvim-tree.renderer.components.modified"
 
-local _padding = require "nvim-tree.renderer.components.padding"
 local icon_component = require "nvim-tree.renderer.components.icons"
-local full_name = require "nvim-tree.renderer.components.full-name"
-local git = require "nvim-tree.renderer.components.git"
-local diagnostics = require "nvim-tree.renderer.components.diagnostics"
-local Builder = require "nvim-tree.renderer.builder"
-local live_filter = require "nvim-tree.live-filter"
-local bookmarks = require "nvim-tree.renderer.components.bookmarks"
 
-local M = {
+local Builder = require "nvim-tree.renderer.builder"
-  last_highlights = {},
-}
 
 local SIGN_GROUP = "NvimTreeRendererSigns"
 
-local namespace_id = vim.api.nvim_create_namespace "NvimTreeHighlights"
+local namespace_highlights_id = vim.api.nvim_create_namespace "NvimTreeHighlights"
+local namespace_extmarks_id = vim.api.nvim_create_namespace "NvimTreeExtmarks"
+local namespace_virtual_lines_id = vim.api.nvim_create_namespace "NvimTreeVirtualLines"
+
+---@class (exact) Renderer
+---@field private __index? table
+---@field private opts table user options
+---@field private explorer Explorer
+---@field private builder Builder
+local Renderer = {}
+
+---@param opts table user options
+---@param explorer Explorer
+---@return Renderer
+function Renderer:new(opts, explorer)
+  ---@type Renderer
+  local o = {
+    opts = opts,
+    explorer = explorer,
+    builder = Builder:new(opts, explorer),
+  }
+
+  setmetatable(o, self)
+  self.__index = self
+
+  return o
+end
+
+---@private
+---@param bufnr number
+---@param lines string[]
+---@param hl_args AddHighlightArgs[]
+---@param signs string[]
+function Renderer:_draw(bufnr, lines, hl_args, signs, extmarks, virtual_lines)
+  if vim.fn.has "nvim-0.10" == 1 then
+    vim.api.nvim_set_option_value("modifiable", true, { buf = bufnr })
+  else
+    vim.api.nvim_buf_set_option(bufnr, "modifiable", true) ---@diagnostic disable-line: deprecated
+  end
 
-local function _draw(bufnr, lines, hl, signs)
-  vim.api.nvim_buf_set_option(bufnr, "modifiable", true)
   vim.api.nvim_buf_set_lines(bufnr, 0, -1, false, lines)
-  M.render_hl(bufnr, hl)
+  self:render_hl(bufnr, hl_args)
-  vim.api.nvim_buf_set_option(bufnr, "modifiable", false)
+
+  if vim.fn.has "nvim-0.10" == 1 then
+    vim.api.nvim_set_option_value("modifiable", false, { buf = bufnr })
+  else
+    vim.api.nvim_buf_set_option(bufnr, "modifiable", false) ---@diagnostic disable-line: deprecated
+  end
+
   vim.fn.sign_unplace(SIGN_GROUP)
-  for _, sign in pairs(signs) do
+  for i, sign_name in pairs(signs) do
-    vim.fn.sign_place(0, SIGN_GROUP, sign.sign, bufnr, { lnum = sign.lnum, priority = sign.priority })
+    vim.fn.sign_place(0, SIGN_GROUP, sign_name, bufnr, { lnum = i + 1 })
+  end
+
+  vim.api.nvim_buf_clear_namespace(bufnr, namespace_extmarks_id, 0, -1)
+  for i, extname in pairs(extmarks) do
+    for _, mark in ipairs(extname) do
+      vim.api.nvim_buf_set_extmark(bufnr, namespace_extmarks_id, i, -1, {
+        virt_text = { { mark.str, mark.hl } },
+        virt_text_pos = "right_align",
+        hl_mode = "combine",
+      })
+    end
+  end
+
+  vim.api.nvim_buf_clear_namespace(bufnr, namespace_virtual_lines_id, 0, -1)
+  for line_nr, vlines in pairs(virtual_lines) do
+    vim.api.nvim_buf_set_extmark(bufnr, namespace_virtual_lines_id, line_nr, 0, {
+      virt_lines = vlines,
+      virt_lines_above = false,
+      virt_lines_leftcol = true,
+    })
   end
 end
 
-function M.render_hl(bufnr, hl)
+---@private
+function Renderer:render_hl(bufnr, hl)
   if not bufnr or not vim.api.nvim_buf_is_loaded(bufnr) then
     return
   end
-  vim.api.nvim_buf_clear_namespace(bufnr, namespace_id, 0, -1)
+  vim.api.nvim_buf_clear_namespace(bufnr, namespace_highlights_id, 0, -1)
-  for _, data in ipairs(hl or M.last_highlights) do
+  for _, data in ipairs(hl) do
     if type(data[1]) == "table" then
       for _, group in ipairs(data[1]) do
-        vim.api.nvim_buf_add_highlight(bufnr, namespace_id, group, data[2], data[3], data[4])
+        vim.api.nvim_buf_add_highlight(bufnr, namespace_highlights_id, group, data[2], data[3], data[4])
       end
     end
   end
 end
 
-local picture_map = {
+function Renderer:draw()
-  jpg = true,
-  jpeg = true,
-  png = true,
-  gif = true,
-  webp = true,
-  jxl = true,
-}
-
-function M.draw(unloaded_bufnr)
   local bufnr = view.get_bufnr()
-  if not core.get_explorer() or not bufnr or not vim.api.nvim_buf_is_loaded(bufnr) then
+  if not bufnr or not vim.api.nvim_buf_is_loaded(bufnr) then
     return
   end
 
   local profile = log.profile_start "draw"
 
-  local cursor = vim.api.nvim_win_get_cursor(view.get_winnr())
+  local cursor = vim.api.nvim_win_get_cursor(view.get_winnr() or 0)
   icon_component.reset_config()
 
-  local lines, hl, signs = Builder.new(core.get_cwd())
+  local builder = Builder:new(self.opts, self.explorer):build()
-    :configure_root_label(M.config.root_folder_label)
-    :configure_trailing_slash(M.config.add_trailing)
-    :configure_special_files(M.config.special_files)
-    :configure_picture_map(picture_map)
-    :configure_opened_file_highlighting(M.config.highlight_opened_files)
-    :configure_modified_highlighting(M.config.highlight_modified)
-    :configure_icon_padding(M.config.icons.padding)
-    :configure_git_icons_placement(M.config.icons.git_placement)
-    :configure_diagnostics_icon_placement(M.config.icons.diagnostics_placement)
-    :configure_bookmark_icon_placement(M.config.icons.bookmarks_placement)
-    :configure_modified_placement(M.config.icons.modified_placement)
-    :configure_symlink_destination(M.config.symlink_destination)
-    :configure_filter(live_filter.filter, live_filter.prefix)
-    :configure_group_name_modifier(M.config.group_empty)
-    :build_header(view.is_root_folder_visible(core.get_cwd()))
-    :build(core.get_explorer(), unloaded_bufnr)
-    :unwrap()
 
-  _draw(bufnr, lines, hl, signs)
+  self:_draw(bufnr, builder.lines, builder.hl_args, builder.signs, builder.extmarks, builder.virtual_lines)
 
-  M.last_highlights = hl
+  if cursor and #builder.lines >= cursor[1] then
-
+    vim.api.nvim_win_set_cursor(view.get_winnr() or 0, cursor)
-  if cursor and #lines >= cursor[1] then
-    vim.api.nvim_win_set_cursor(view.get_winnr(), cursor)
   end
 
   view.grow_from_content()
@@ -100,17 +124,4 @@ function M.draw(unloaded_bufnr)
   events._dispatch_on_tree_rendered(bufnr, view.get_winnr())
 end
 
-function M.setup(opts)
+return Renderer
-  M.config = opts.renderer
-  M.config.modified = opts.modified
-
-  _padding.setup(opts)
-  full_name.setup(opts)
-  git.setup(opts)
-  modified.setup(opts)
-  diagnostics.setup(opts)
-  bookmarks.setup(opts)
-  icon_component.setup(opts)
-end
-
-return M

lua/nvim-tree/utils.lua

@@ -112,10 +112,35 @@ function M.find_node(nodes, fn)
     end)
     :iterate()
   i = require("nvim-tree.view").is_root_folder_visible() and i or i - 1
-  i = require("nvim-tree.live-filter").filter and i + 1 or i
+  local explorer = require("nvim-tree.core").get_explorer()
+  if explorer and explorer.live_filter.filter then
+    i = i + 1
+  end
   return node, i
 end
 
+-- Find the line number of a node.
+-- Return -1 is node is nil or not found.
+---@param node Node|nil
+---@return integer
+function M.find_node_line(node)
+  if not node then
+    return -1
+  end
+
+  local first_node_line = require("nvim-tree.core").get_nodes_starting_line()
+  local nodes_by_line = M.get_nodes_by_line(require("nvim-tree.core").get_explorer().nodes, first_node_line)
+  local iter_start, iter_end = first_node_line, #nodes_by_line
+
+  for line = iter_start, iter_end, 1 do
+    if nodes_by_line[line] == node then
+      return line
+    end
+  end
+
+  return -1
+end
+
 -- get the node in the tree state depending on the absolute path of the node
 -- (grouped or hidden too)
 ---@param path string
@@ -149,17 +174,36 @@ function M.get_node_from_path(path)
     :iterate()
 end
 
---- Get the highest parent of grouped nodes
+---Get the highest parent of grouped nodes
----@param node_ Node
+---@param node Node
----@return table
+---@return Node node or parent
-function M.get_parent_of_group(node_)
+function M.get_parent_of_group(node)
-  local node = node_
+  while node and node.parent and node.parent.group_next do
-  while node.parent and node.parent.group_next do
     node = node.parent
   end
   return node
 end
 
+M.default_format_hidden_count = function(hidden_count, simple)
+  local parts = {}
+  local total_count = 0
+  for reason, count in pairs(hidden_count) do
+    total_count = total_count + count
+    if count > 0 then
+      table.insert(parts, reason .. ": " .. tostring(count))
+    end
+  end
+
+  local hidden_count_string = table.concat(parts, ", ") -- if empty then is "" (empty string)
+  if simple then
+    hidden_count_string = ""
+  end
+  if total_count > 0 then
+    return "(" .. tostring(total_count) .. (simple and " hidden" or " total ") .. hidden_count_string .. ")"
+  end
+  return nil
+end
+
 --- Return visible nodes indexed by line
 ---@param nodes_all Node[]
 ---@param line_start number
@@ -205,7 +249,14 @@ function M.rename_loaded_buffers(old_path, new_path)
         vim.api.nvim_buf_set_name(buf, new_path .. buf_name:sub(#old_path + 1))
         -- to avoid the 'overwrite existing file' error message on write for
         -- normal files
-        if vim.api.nvim_buf_get_option(buf, "buftype") == "" then
+        local buftype
+        if vim.fn.has "nvim-0.10" == 1 then
+          buftype = vim.api.nvim_get_option_value("buftype", { buf = buf })
+        else
+          buftype = vim.api.nvim_buf_get_option(buf, "buftype") ---@diagnostic disable-line: deprecated
+        end
+
+        if buftype == "" then
           vim.api.nvim_buf_call(buf, function()
             vim.cmd "silent! write!"
             vim.cmd "edit"
@@ -239,7 +290,7 @@ function M.escape_special_chars(path)
   if path == nil then
     return path
   end
-  return M.is_windows and path:gsub("%(", "\\("):gsub("%)", "\\)") or path
+  return M.is_windows and path:gsub("\\", "/") or path
 end
 
 --- Create empty sub-tables if not present
@@ -385,6 +436,9 @@ function M.debounce(context, timeout, callback)
   end
 
   local timer = vim.loop.new_timer()
+  if not timer then
+    return
+  end
   debouncer.timer = timer
   timer:start(timeout, 0, function()
     timer_stop_close(timer)

lua/nvim-tree/view.lua

@@ -1,6 +1,7 @@
 local events = require "nvim-tree.events"
 local utils = require "nvim-tree.utils"
 local log = require "nvim-tree.log"
+local notify = require "nvim-tree.notify"
 
 ---@class OpenInWinOpts
 ---@field hijack_current_buf boolean|nil default true
@@ -50,6 +51,7 @@ M.View = {
       "Normal:NvimTreeNormal",
       "NormalNC:NvimTreeNormalNC",
       "NormalFloat:NvimTreeNormalFloat",
+      "FloatBorder:NvimTreeNormalFloatBorder",
     }, ","),
   },
 }
@@ -108,7 +110,7 @@ local function create_buffer(bufnr)
   events._dispatch_tree_attached_post(M.get_bufnr())
 end
 
----@param size number|fun():number
+---@param size (fun():integer)|integer|string
 ---@return integer
 local function get_size(size)
   if type(size) == "number" then
@@ -121,10 +123,13 @@ local function get_size(size)
   return math.floor(vim.o.columns * percent_as_decimal)
 end
 
----@param size number|function|nil
+---@param size (fun():integer)|integer|nil
 local function get_width(size)
-  size = size or M.View.width
+  if size then
-  return get_size(size)
+    return get_size(size)
+  else
+    return get_size(M.View.width)
+  end
 end
 
 local move_tbl = {
@@ -140,7 +145,7 @@ local function setup_tabpage(tabpage)
 end
 
 local function set_window_options_and_buffer()
-  pcall(vim.cmd, "buffer " .. M.get_bufnr())
+  pcall(vim.api.nvim_command, "buffer " .. M.get_bufnr())
   local eventignore = vim.opt.eventignore:get()
   vim.opt.eventignore = "all"
   for k, v in pairs(M.View.winopts) do
@@ -204,7 +209,7 @@ end
 ---@param tabnr integer
 local function save_tab_state(tabnr)
   local tabpage = tabnr or vim.api.nvim_get_current_tabpage()
-  M.View.cursors[tabpage] = vim.api.nvim_win_get_cursor(M.get_winnr(tabpage))
+  M.View.cursors[tabpage] = vim.api.nvim_win_get_cursor(M.get_winnr(tabpage) or 0)
 end
 
 ---@param tabpage integer
@@ -222,8 +227,12 @@ local function close(tabpage)
       if tree_win == current_win and prev_win > 0 then
         vim.api.nvim_set_current_win(vim.fn.win_getid(prev_win))
       end
-      if vim.api.nvim_win_is_valid(tree_win) then
+      if vim.api.nvim_win_is_valid(tree_win or 0) then
-        vim.api.nvim_win_close(tree_win, true)
+        local success, error = pcall(vim.api.nvim_win_close, tree_win or 0, true)
+        if not success then
+          notify.debug("Failed to close window: " .. error)
+          return
+        end
       end
       events._dispatch_on_tree_close()
       return
@@ -342,18 +351,18 @@ function M.resize(size)
     return
   end
 
+  local winnr = M.get_winnr() or 0
+
   local new_size = get_width()
-  vim.api.nvim_win_set_width(M.get_winnr(), new_size)
 
-  -- TODO #1545 remove similar check from setup_autocommands
+  if new_size ~= vim.api.nvim_win_get_width(winnr) then
-  -- We let nvim handle sending resize events after 0.9
+    vim.api.nvim_win_set_width(winnr, new_size)
-  if vim.fn.has "nvim-0.9" == 0 then
+    if not M.View.preserve_window_proportions then
-    events._dispatch_on_tree_resize(new_size)
+      vim.cmd ":wincmd ="
+    end
   end
 
-  if not M.View.preserve_window_proportions then
+  events._dispatch_on_tree_resize(new_size)
-    vim.cmd ":wincmd ="
-  end
 end
 
 function M.reposition_window()
@@ -420,7 +429,7 @@ function M.is_visible(opts)
     return false
   end
 
-  return M.get_winnr() ~= nil and vim.api.nvim_win_is_valid(M.get_winnr())
+  return M.get_winnr() ~= nil and vim.api.nvim_win_is_valid(M.get_winnr() or 0)
 end
 
 ---@param opts table|nil
@@ -443,7 +452,9 @@ function M.focus(winnr, open_if_closed)
     M.open()
   end
 
-  vim.api.nvim_set_current_win(wnr)
+  if wnr then
+    vim.api.nvim_set_current_win(wnr)
+  end
 end
 
 --- Retrieve the winid of the open tree.
@@ -473,7 +484,7 @@ end
 function M.get_winnr(tabpage)
   tabpage = tabpage or vim.api.nvim_get_current_tabpage()
   local tabinfo = M.View.tabpages[tabpage]
-  if tabinfo ~= nil then
+  if tabinfo and tabinfo.winnr and vim.api.nvim_win_is_valid(tabinfo.winnr) then
     return tabinfo.winnr
   end
 end
@@ -520,7 +531,12 @@ function M._prevent_buffer_override()
     vim.cmd "setlocal nowinfixwidth"
     vim.cmd "setlocal nowinfixheight"
     M.open { focus_tree = false }
-    require("nvim-tree.renderer").draw()
+
+    local explorer = require("nvim-tree.core").get_explorer()
+    if explorer then
+      explorer.renderer:draw()
+    end
+
     pcall(vim.api.nvim_win_close, curwin, { force = true })
 
     -- to handle opening a file using :e when nvim-tree is on floating mode
@@ -541,11 +557,40 @@ end
 
 -- used on ColorScheme event
 function M.reset_winhl()
-  if M.get_winnr() and vim.api.nvim_win_is_valid(M.get_winnr()) then
+  local winnr = M.get_winnr()
+  if winnr and vim.api.nvim_win_is_valid(winnr) then
     vim.wo[M.get_winnr()].winhl = M.View.winopts.winhl
   end
 end
 
+---Check if width determined or calculated on-fly
+---@return boolean
+function M.is_width_determined()
+  return type(M.View.width) ~= "function"
+end
+
+---Configure width-related config
+---@param width string|function|number|table|nil
+function M.configure_width(width)
+  if type(width) == "table" then
+    M.View.adaptive_size = true
+    M.View.width = width.min or DEFAULT_MIN_WIDTH
+    M.View.max_width = width.max or DEFAULT_MAX_WIDTH
+    M.View.padding = width.padding or DEFAULT_PADDING
+  elseif width == nil then
+    if M.config.width ~= nil then
+      -- if we had input config - fallback to it
+      M.configure_width(M.config.width)
+    else
+      -- otherwise - restore initial width
+      M.View.width = M.View.initial_width
+    end
+  else
+    M.View.adaptive_size = false
+    M.View.width = width
+  end
+end
+
 function M.setup(opts)
   local options = opts.view or {}
   M.View.centralize_selection = options.centralize_selection
@@ -561,15 +606,8 @@ function M.setup(opts)
   M.View.float = options.float
   M.on_attach = opts.on_attach
 
-  if type(options.width) == "table" then
+  M.config = options
-    M.View.adaptive_size = true
+  M.configure_width(options.width)
-    M.View.width = options.width.min or DEFAULT_MIN_WIDTH
-    M.View.max_width = options.width.max or DEFAULT_MAX_WIDTH
-    M.View.padding = options.width.padding or DEFAULT_PADDING
-  else
-    M.View.adaptive_size = false
-    M.View.width = options.width
-  end
 
   M.View.initial_width = get_width()
 end

release-please-config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
+  "include-v-in-tag": true,
+  "bootstrap-sha": "34780aca5bac0a58c163ea30719a276fead1bd95",
+  "packages": {
+    ".": {
+      "package-name": "nvim-tree",
+      "release-type": "simple"
+    }
+  }
+}

scripts/doc-comments.sh

@@ -0,0 +1,16 @@
+#!/bin/bash
+
+out=$(grep -nr "^--- @" lua)
+
+if [ "$out" ]; then
+	last_file=""
+	while read -r line; do
+		file="$(echo "$line" | cut -d: -f1)"
+		if [[ "$file" != "$last_file" ]]; then
+			echo "$file:" >&2
+			last_file="$file"
+		fi
+		echo "$line" | awk -F: '{ printf("  line %s: %s\n", $2, $3) }' >&2
+	done <<< "$out"
+	exit 1
+fi

scripts/help-update.sh

@@ -2,7 +2,7 @@
 
 # run after changing nvim-tree.lua DEFAULT_OPTS or keymap.lua M.default_on_attach
 # scrapes and updates nvim-tree-lua.txt
-# run from repository root: scripts/update-help.sh
+# run from repository root: scripts/help-update.sh  OR  make help-update
 
 
 #
@@ -21,6 +21,39 @@ sed -e "s/^  /      /" /tmp/DEFAULT_OPTS.2.lua > /tmp/DEFAULT_OPTS.6.lua
 sed -i -e "/${begin}/,/${end}/{ /${begin}/{p; r /tmp/DEFAULT_OPTS.6.lua
            }; /${end}/p; d; }" doc/nvim-tree-lua.txt
 
+
+#
+# opts index
+#
+begin="nvim-tree-index-opts\*"
+end="====================="
+
+printf '\n' > /tmp/index-opts.txt
+sed -E "
+/^ *\*(nvim-tree\..*)\*$/! d ;
+s/^.*\*(.*)\*/|\1|/g
+" doc/nvim-tree-lua.txt | sort -d >> /tmp/index-opts.txt
+printf '\n' >> /tmp/index-opts.txt
+
+sed -i -e "/${begin}/,/${end}/{ /${begin}/{p; r /tmp/index-opts.txt
+           }; /${end}/p; d; }" doc/nvim-tree-lua.txt
+
+#
+# api index
+#
+begin="nvim-tree-index-api\*"
+end="====================="
+
+printf '\n' > /tmp/index-api.txt
+sed -E "
+/\*(nvim-tree-api.*\(\))\*/! d ;
+s/^.*\*(.*)\*/|\1|/g
+" doc/nvim-tree-lua.txt | sort -d >> /tmp/index-api.txt
+printf '\n' >> /tmp/index-api.txt
+
+sed -i -e "/${begin}/,/${end}/{ /${begin}/{p; r /tmp/index-api.txt
+           }; /${end}/p; d; }" doc/nvim-tree-lua.txt
+
 #
 # DEFAULT_ON_ATTACH
 #
@@ -38,7 +71,7 @@ sed -i -e "/${begin}/,/${end}/{ /${begin}/{p; r /tmp/DEFAULT_ON_ATTACH.lua
 # help human
 echo > /tmp/DEFAULT_ON_ATTACH.help
 sed -E "s/^ *vim.keymap.set\('n', '(.*)',.*api(.*),.*opts\('(.*)'.*$/'\`\1\`' '\3' '|nvim-tree-api\2()|'/g
-" /tmp/DEFAULT_ON_ATTACH.lua | while read line
+" /tmp/DEFAULT_ON_ATTACH.lua | while read -r line
 do
 	eval "printf '%-17.17s %-26.26s %s\n' ${line}" >> /tmp/DEFAULT_ON_ATTACH.help
 done

scripts/luals-check.sh

@@ -0,0 +1,40 @@
+#!/bin/sh
+
+# Performs a lua-language-server check on all files.
+# luals-out/check.json will be produced on any issues, returning 1.
+# Outputs only check.json to stdout, all other messages to stderr, to allow jq etc.
+# $VIMRUNTIME specifies neovim runtime path, defaults to "/usr/share/nvim/runtime" if unset.
+
+if [ -z "${VIMRUNTIME}" ]; then
+	export VIMRUNTIME="/usr/share/nvim/runtime"
+fi
+
+DIR_SRC="lua"
+DIR_OUT="luals-out"
+
+# clear output
+rm -rf "${DIR_OUT}"
+mkdir "${DIR_OUT}"
+
+# execute inside lua to prevent luals itself from being checked
+OUT=$(lua-language-server --check="${DIR_SRC}" --configpath="${PWD}/.luarc.json" --checklevel=Information --logpath="${DIR_OUT}" --loglevel=error)
+RC=$?
+
+echo "${OUT}" >&2
+
+if [ $RC -ne 0 ]; then
+	echo "failed with RC=$RC"
+	exit $RC
+fi
+
+# any output is a fail
+case "${OUT}" in
+	*Diagnosis\ completed,\ no\ problems\ found*)
+		exit 0
+		;;
+	*)
+		cat "${DIR_OUT}/check.json"
+		exit 1
+		;;
+esac
+