[{"result":{"data":[{"id":"76cac76a-ca5c-48d5-acbb-72dfb6f7488b","title":"feat!: rename `label` to `desc` for mapping descriptions (#1190)","text":"feat!: rename `label` to `desc` for mapping descriptions (#1190)","type":"breaking-change","createdAt":"2023-10-20T02:14:16.309Z","breakingChange":{"id":73,"postId":"76cac76a-ca5c-48d5-acbb-72dfb6f7488b","pluginId":102,"externalUrl":"https://github.com/nvim-neo-tree/neo-tree.nvim/commit/887a95853412cba01dc48b20f5a2bf743431b7a3","sha":"887a95853412cba01dc48b20f5a2bf743431b7a3","plugin":{"id":102,"owner":"nvim-neo-tree","name":"neo-tree.nvim","type":"github","source":"awesome-neovim","category":"file-explorer","link":"https://github.com/nvim-neo-tree/neo-tree.nvim","shortDescription":"Neovim plugin to manage the file system and other tree like structures.","createdAt":"2023-03-22T19:35:21.577Z","readme":"# Neo-tree.nvim\n\nNeo-tree is a Neovim plugin to browse the file system and other tree like\nstructures in whatever style suits you, including sidebars, floating windows,\nnetrw split style, or all of them at once!\n\n### Neo-tree filesystem as Sidebar:\n\nThis screenshot shows Neo-tree opened in the traditional sidebar layout:\n\n![Neo-tree file system sidebar](https://github.com/nvim-neo-tree/resources/blob/main/images/Neo-tree-with-right-aligned-symbols.png)\n\n### Neo-tree filesystem Netrw Style\n\nThe below screenshot shows Neo-tree opened \"netrw style\" (`:Neotree position=current`). When opened in this way,\nthere is more room so the extra detail columns can be shown. This screenshot also shows how the contents can be\nsorted on any column. In this example, we are sorted on \"Size\" descending:\n\n![Neo-tree file system\ndetails](https://github.com/nvim-neo-tree/resources/blob/main/images/Neo-tree-with-file-details-and-sort.png)\n\n### Breaking Changes BAD :bomb: :imp:\n\nThe biggest and most important feature of Neo-tree is that we will never\nknowingly push a breaking change and interrupt your day. Bugs happen, but\nbreaking changes can always be avoided. When breaking changes are needed, there\nwill be a new branch that you can opt into, when it is a good time for you.\n\nSee [What is a Breaking Change?](#what-is-a-breaking-change) for details.\n\nSee [Changelog 3.0](https://github.com/nvim-neo-tree/neo-tree.nvim/wiki/Changelog#30)\nfor breaking changes and deprecations in 3.0.\n\n\n### User Experience GOOD :slightly_smiling_face: :thumbsup:\n\nAside from being polite about breaking changes, Neo-tree is also focused on the\nlittle details of user experience. Everything should work exactly as you would\nexpect a sidebar to work without all of the glitchy behavior that is normally\naccepted in (neo)vim sidebars. I can't stand glitchy behavior, and neither\nshould you!\n\n- Neo-tree won't let other buffers take over its window.\n- Neo-tree won't leave its window scrolled to the last line when there is\n plenty of room to display the whole tree.\n- Neo-tree does not need to be manually refreshed (set `use_libuv_file_watcher=true`)\n- Neo-tree can intelligently follow the current file (set `follow_current_file.enabled=true`)\n- Neo-tree is thoughtful about maintaining or setting focus on the right node\n- Neo-tree windows in different tabs are completely separate\n- `respect_gitignore` actually works!\n\nNeo-tree is smooth, efficient, stable, and pays attention to the little details.\nIf you find anything janky, wanky, broken, or unintuitive, please open an issue\nso we can fix it.\n\n\n## Minimal Quickstart\n\n#### Minimal Example for Lazy:\n```lua\n{\n \"nvim-neo-tree/neo-tree.nvim\",\n branch = \"v3.x\",\n dependencies = {\n \"nvim-lua/plenary.nvim\",\n \"nvim-tree/nvim-web-devicons\", -- not strictly required, but recommended\n \"MunifTanjim/nui.nvim\",\n -- \"3rd/image.nvim\", -- Optional image support in preview window: See `# Preview Mode` for more information\n }\n}\n```\n\n#### Minimal Example for Packer:\n```lua\nuse {\n \"nvim-neo-tree/neo-tree.nvim\",\n branch = \"v3.x\",\n requires = { \n \"nvim-lua/plenary.nvim\",\n \"nvim-tree/nvim-web-devicons\", -- not strictly required, but recommended\n \"MunifTanjim/nui.nvim\",\n -- \"3rd/image.nvim\", -- Optional image support in preview window: See `# Preview Mode` for more information\n }\n }\n```\n\nAfter installing, run:\n```\n:Neotree\n```\n\nPress `?` in the Neo-tree window to view the list of mappings.\n\n\n## Quickstart\n\n#### Longer Example for Packer:\n \n```lua\nuse {\n \"nvim-neo-tree/neo-tree.nvim\",\n branch = \"v3.x\",\n requires = { \n \"nvim-lua/plenary.nvim\",\n \"nvim-tree/nvim-web-devicons\", -- not strictly required, but recommended\n \"MunifTanjim/nui.nvim\",\n -- \"3rd/image.nvim\", -- Optional image support in preview window: See `# Preview Mode` for more information\n {\n 's1n7ax/nvim-window-picker',\n version = '2.*',\n config = function()\n require 'window-picker'.setup({\n filter_rules = {\n include_current_win = false,\n autoselect_one = true,\n -- filter using buffer options\n bo = {\n -- if the file type is one of following, the window will be ignored\n filetype = { 'neo-tree', \"neo-tree-popup\", \"notify\" },\n -- if the buffer type is one of following, the window will be ignored\n buftype = { 'terminal', \"quickfix\" },\n },\n },\n })\n end,\n },\n },\n config = function ()\n -- If you want icons for diagnostic errors, you'll need to define them somewhere:\n vim.fn.sign_define(\"DiagnosticSignError\",\n {text = \" \", texthl = \"DiagnosticSignError\"})\n vim.fn.sign_define(\"DiagnosticSignWarn\",\n {text = \" \", texthl = \"DiagnosticSignWarn\"})\n vim.fn.sign_define(\"DiagnosticSignInfo\",\n {text = \" \", texthl = \"DiagnosticSignInfo\"})\n vim.fn.sign_define(\"DiagnosticSignHint\",\n {text = \"󰌵\", texthl = \"DiagnosticSignHint\"})\n\n require(\"neo-tree\").setup({\n close_if_last_window = false, -- Close Neo-tree if it is the last window left in the tab\n popup_border_style = \"rounded\",\n enable_git_status = true,\n enable_diagnostics = true,\n enable_normal_mode_for_inputs = false, -- Enable normal mode for input dialogs.\n open_files_do_not_replace_types = { \"terminal\", \"trouble\", \"qf\" }, -- when opening files, do not use windows containing these filetypes or buftypes\n sort_case_insensitive = false, -- used when sorting files and directories in the tree\n sort_function = nil , -- use a custom function for sorting files and directories in the tree \n -- sort_function = function (a,b)\n -- if a.type == b.type then\n -- return a.path > b.path\n -- else\n -- return a.type > b.type\n -- end\n -- end , -- this sorts files and directories descendantly\n default_component_configs = {\n container = {\n enable_character_fade = true\n },\n indent = {\n indent_size = 2,\n padding = 1, -- extra padding on left hand side\n -- indent guides\n with_markers = true,\n indent_marker = \"│\",\n last_indent_marker = \"└\",\n highlight = \"NeoTreeIndentMarker\",\n -- expander config, needed for nesting files\n with_expanders = nil, -- if nil and file nesting is enabled, will enable expanders\n expander_collapsed = \"\",\n expander_expanded = \"\",\n expander_highlight = \"NeoTreeExpander\",\n },\n icon = {\n folder_closed = \"\",\n folder_open = \"\",\n folder_empty = \"󰜌\",\n -- The next two settings are only a fallback, if you use nvim-web-devicons and configure default icons there\n -- then these will never be used.\n default = \"*\",\n highlight = \"NeoTreeFileIcon\"\n },\n modified = {\n symbol = \"[+]\",\n highlight = \"NeoTreeModified\",\n },\n name = {\n trailing_slash = false,\n use_git_status_colors = true,\n highlight = \"NeoTreeFileName\",\n },\n git_status = {\n symbols = {\n -- Change type\n added = \"\", -- or \"✚\", but this is redundant info if you use git_status_colors on the name\n modified = \"\", -- or \"\", but this is redundant info if you use git_status_colors on the name\n deleted = \"✖\",-- this can only be used in the git_status source\n renamed = \"󰁕\",-- this can only be used in the git_status source\n -- Status type\n untracked = \"\",\n ignored = \"\",\n unstaged = \"󰄱\",\n staged = \"\",\n conflict = \"\",\n }\n },\n -- If you don't want to use these columns, you can set `enabled = false` for each of them individually\n file_size = {\n enabled = true,\n required_width = 64, -- min width of window required to show this column\n },\n type = {\n enabled = true,\n required_width = 122, -- min width of window required to show this column\n },\n last_modified = {\n enabled = true,\n required_width = 88, -- min width of window required to show this column\n },\n created = {\n enabled = true,\n required_width = 110, -- min width of window required to show this column\n },\n symlink_target = {\n enabled = false,\n },\n },\n -- A list of functions, each representing a global custom command\n -- that will be available in all sources (if not overridden in `opts[source_name].commands`)\n -- see `:h neo-tree-custom-commands-global`\n commands = {},\n window = {\n position = \"left\",\n width = 40,\n mapping_options = {\n noremap = true,\n nowait = true,\n },\n mappings = {\n [\"\"] = { \n \"toggle_node\", \n nowait = false, -- disable `nowait` if you have existing combos starting with this char that you want to use \n },\n [\"<2-LeftMouse>\"] = \"open\",\n [\"\"] = \"open\",\n [\"\"] = \"cancel\", -- close preview or floating neo-tree window\n [\"P\"] = { \"toggle_preview\", config = { use_float = true, use_image_nvim = true } },\n -- Read `# Preview Mode` for more information\n [\"l\"] = \"focus_preview\",\n [\"S\"] = \"open_split\",\n [\"s\"] = \"open_vsplit\",\n -- [\"S\"] = \"split_with_window_picker\",\n -- [\"s\"] = \"vsplit_with_window_picker\",\n [\"t\"] = \"open_tabnew\",\n -- [\"\"] = \"open_drop\",\n -- [\"t\"] = \"open_tab_drop\",\n [\"w\"] = \"open_with_window_picker\",\n --[\"P\"] = \"toggle_preview\", -- enter preview mode, which shows the current node without focusing\n [\"C\"] = \"close_node\",\n -- ['C'] = 'close_all_subnodes',\n [\"z\"] = \"close_all_nodes\",\n --[\"Z\"] = \"expand_all_nodes\",\n [\"a\"] = { \n \"add\",\n -- this command supports BASH style brace expansion (\"x{a,b,c}\" -> xa,xb,xc). see `:h neo-tree-file-actions` for details\n -- some commands may take optional config options, see `:h neo-tree-mappings` for details\n config = {\n show_path = \"none\" -- \"none\", \"relative\", \"absolute\"\n }\n },\n [\"A\"] = \"add_directory\", -- also accepts the optional config.show_path option like \"add\". this also supports BASH style brace expansion.\n [\"d\"] = \"delete\",\n [\"r\"] = \"rename\",\n [\"y\"] = \"copy_to_clipboard\",\n [\"x\"] = \"cut_to_clipboard\",\n [\"p\"] = \"paste_from_clipboard\",\n [\"c\"] = \"copy\", -- takes text input for destination, also accepts the optional config.show_path option like \"add\":\n -- [\"c\"] = {\n -- \"copy\",\n -- config = {\n -- show_path = \"none\" -- \"none\", \"relative\", \"absolute\"\n -- }\n --}\n [\"m\"] = \"move\", -- takes text input for destination, also accepts the optional config.show_path option like \"add\".\n [\"q\"] = \"close_window\",\n [\"R\"] = \"refresh\",\n [\"?\"] = \"show_help\",\n [\"<\"] = \"prev_source\",\n [\">\"] = \"next_source\",\n [\"i\"] = \"show_file_details\",\n }\n },\n nesting_rules = {},\n filesystem = {\n filtered_items = {\n visible = false, -- when true, they will just be displayed differently than normal items\n hide_dotfiles = true,\n hide_gitignored = true,\n hide_hidden = true, -- only works on Windows for hidden files/directories\n hide_by_name = {\n --\"node_modules\"\n },\n hide_by_pattern = { -- uses glob style patterns\n --\"*.meta\",\n --\"*/src/*/tsconfig.json\",\n },\n always_show = { -- remains visible even if other settings would normally hide it\n --\".gitignored\",\n },\n never_show = { -- remains hidden even if visible is toggled to true, this overrides always_show\n --\".DS_Store\",\n --\"thumbs.db\"\n },\n never_show_by_pattern = { -- uses glob style patterns\n --\".null-ls_*\",\n },\n },\n follow_current_file = {\n enabled = false, -- This will find and focus the file in the active buffer every time\n -- -- the current file is changed while the tree is open.\n leave_dirs_open = false, -- `false` closes auto expanded dirs, such as with `:Neotree reveal`\n },\n group_empty_dirs = false, -- when true, empty folders will be grouped together\n hijack_netrw_behavior = \"open_default\", -- netrw disabled, opening a directory opens neo-tree\n -- in whatever position is specified in window.position\n -- \"open_current\", -- netrw disabled, opening a directory opens within the\n -- window like netrw would, regardless of window.position\n -- \"disabled\", -- netrw left alone, neo-tree does not handle opening dirs\n use_libuv_file_watcher = false, -- This will use the OS level file watchers to detect changes\n -- instead of relying on nvim autocmd events.\n window = {\n mappings = {\n [\"\"] = \"navigate_up\",\n [\".\"] = \"set_root\",\n [\"H\"] = \"toggle_hidden\",\n [\"/\"] = \"fuzzy_finder\",\n [\"D\"] = \"fuzzy_finder_directory\",\n [\"#\"] = \"fuzzy_sorter\", -- fuzzy sorting using the fzy algorithm\n -- [\"D\"] = \"fuzzy_sorter_directory\",\n [\"f\"] = \"filter_on_submit\",\n [\"\"] = \"clear_filter\",\n [\"[g\"] = \"prev_git_modified\",\n [\"]g\"] = \"next_git_modified\",\n [\"o\"] = { \"show_help\", nowait=false, config = { title = \"Order by\", prefix_key = \"o\" }},\n [\"oc\"] = { \"order_by_created\", nowait = false },\n [\"od\"] = { \"order_by_diagnostics\", nowait = false },\n [\"og\"] = { \"order_by_git_status\", nowait = false },\n [\"om\"] = { \"order_by_modified\", nowait = false },\n [\"on\"] = { \"order_by_name\", nowait = false },\n [\"os\"] = { \"order_by_size\", nowait = false },\n [\"ot\"] = { \"order_by_type\", nowait = false },\n },\n fuzzy_finder_mappings = { -- define keymaps for filter popup window in fuzzy_finder_mode\n [\"\"] = \"move_cursor_down\",\n [\"\"] = \"move_cursor_down\",\n [\"\"] = \"move_cursor_up\",\n [\"\"] = \"move_cursor_up\",\n },\n },\n\n commands = {} -- Add a custom command or override a global one using the same function name\n },\n buffers = {\n follow_current_file = {\n enabled = true, -- This will find and focus the file in the active buffer every time\n -- -- the current file is changed while the tree is open.\n leave_dirs_open = false, -- `false` closes auto expanded dirs, such as with `:Neotree reveal`\n },\n group_empty_dirs = true, -- when true, empty folders will be grouped together\n show_unloaded = true,\n window = {\n mappings = {\n [\"bd\"] = \"buffer_delete\",\n [\"\"] = \"navigate_up\",\n [\".\"] = \"set_root\",\n [\"o\"] = { \"show_help\", nowait=false, config = { title = \"Order by\", prefix_key = \"o\" }},\n [\"oc\"] = { \"order_by_created\", nowait = false },\n [\"od\"] = { \"order_by_diagnostics\", nowait = false },\n [\"om\"] = { \"order_by_modified\", nowait = false },\n [\"on\"] = { \"order_by_name\", nowait = false },\n [\"os\"] = { \"order_by_size\", nowait = false },\n [\"ot\"] = { \"order_by_type\", nowait = false },\n }\n },\n },\n git_status = {\n window = {\n position = \"float\",\n mappings = {\n [\"A\"] = \"git_add_all\",\n [\"gu\"] = \"git_unstage_file\",\n [\"ga\"] = \"git_add_file\",\n [\"gr\"] = \"git_revert_file\",\n [\"gc\"] = \"git_commit\",\n [\"gp\"] = \"git_push\",\n [\"gg\"] = \"git_commit_and_push\",\n [\"o\"] = { \"show_help\", nowait=false, config = { title = \"Order by\", prefix_key = \"o\" }},\n [\"oc\"] = { \"order_by_created\", nowait = false },\n [\"od\"] = { \"order_by_diagnostics\", nowait = false },\n [\"om\"] = { \"order_by_modified\", nowait = false },\n [\"on\"] = { \"order_by_name\", nowait = false },\n [\"os\"] = { \"order_by_size\", nowait = false },\n [\"ot\"] = { \"order_by_type\", nowait = false },\n }\n }\n }\n })\n\n vim.cmd([[nnoremap \\ :Neotree reveal]])\n end\n}\n```\n\n_The above configuration is not everything that can be changed, it's just the\nparts you might want to change first._\n\n\nSee `:h neo-tree` for full documentation. You can also preview that online at\n[doc/neo-tree.txt](doc/neo-tree.txt), although it's best viewed within vim.\n\n\nTo see all of the default config options with commentary, you can view it online\nat [lua/neo-tree/defaults.lua](lua/neo-tree/defaults.lua). You can also paste it\ninto a buffer after installing Neo-tree by running: \n\n```\n:lua require(\"neo-tree\").paste_default_config()\n```\n\n## The `:Neotree` Command\n\nThe single `:Neotree` command accepts a range of arguments that give you full\ncontrol over the details of what and where it will show. For example, the following \ncommand will open a file browser on the right hand side, \"revealing\" the currently\nactive file:\n\n```\n:Neotree filesystem reveal right\n```\n\nArguments can be specified as either a key=value pair or just as the value. The\nkey=value form is more verbose but may help with clarity. For example, the command\nabove can also be specified as:\n\n```\n:Neotree source=filesystem reveal=true position=right\n```\n\nAll arguments are optional and can be specified in any order. If you issue the command\nwithout any arguments, it will use default values for everything. For example:\n\n```\n:Neotree\n```\n\nwill open the filesystem source on the left hand side and focus it, if you are using \nthe default config.\n\n### Tab Completion\n\nNeotree supports tab completion for all arguments. Once a given argument has a value,\nit will stop suggesting those completions. It will also offer completions for paths.\nThe simplest way to disambiguate a path from another type of argument is to start\nthem with `/` or `./`.\n\n### Arguments\n\nHere is the full list of arguments you can use:\n\n#### `action`\nWhat to do. Can be one of:\n\n| Option | Description |\n|--------|-------------|\n| focus | Show and/or switch focus to the specified Neotree window. DEFAULT |\n| show | Show the window, but keep focus on your current window. |\n| close | Close the window(s) specified. Can be combined with \"position\" and/or \"source\" to specify which window(s) to close. |\n\n#### `source`\nWhat to show. Can be one of:\n\n| Option | Description |\n|--------|-------------|\n| filesystem | Show a file browser. DEFAULT |\n| buffers | Show a list of currently open buffers. |\n| git_status | Show the output of `git status` in a tree layout. |\n| last | Equivalent to the last source used |\n\n#### `position`\nWhere to show it, can be one of:\n\n| Option | Description |\n|---------|-------------|\n| left | Open as left hand sidebar. DEFAULT |\n| right | Open as right hand sidebar. |\n| top | Open as top window. |\n| bottom | Open as bottom window. |\n| float | Open as floating window. |\n| current | Open within the current window, like netrw or vinegar would. |\n\n#### `toggle`\nThis is a boolean flag. Adding this means that the window will be closed if it\nis already open.\n\n#### `dir`\nThe directory to set as the root/cwd of the specified window. If you include a\ndirectory as one of the arguments, it will be assumed to be this option, you\ndon't need the full dir=/path. You may use any value that can be passed to the\n'expand' function, such as `%:p:h:h` to specify two directories up from the\ncurrent file. For example:\n\n```\n:Neotree ./relative/path\n:Neotree /home/user/relative/path\n:Neotree dir=/home/user/relative/path\n:Neotree position=current dir=relative/path\n```\n\n#### `git_base`\nThe base that is used to calculate the git status for each dir/file.\nBy default it uses `HEAD`, so it shows all changes that are not yet committed.\nYou can for example work on a feature branch, and set it to `main`. It will\nshow all changes that happened on the feature branch and main since you \nbranched off.\n\nAny git ref, commit, tag, or sha will work.\n\n```\n:Neotree main\n:Neotree v1.0\n:Neotree git_base=8fe34be\n:Neotree git_base=HEAD\n```\n\n#### `reveal`\nThis is a boolean flag. Adding this will make Neotree automatically find and \nfocus the current file when it opens.\n\n#### `reveal_file`\nA path to a file to reveal. This supersedes the \"reveal\" flag so there is no\nneed to specify both. Use this if you want to reveal something other than the\ncurrent file. If you include a path to a file as one of the arguments, it will\nbe assumed to be this option. Like \"dir\", you can pass any value that can be\npassed to the 'expand' function. For example:\n\n```\n:Neotree reveal_file=/home/user/my/file.text\n:Neotree position=current dir=%:p:h:h reveal_file=%:p\n:Neotree current %:p:h:h %:p\n```\n\nOne neat trick you can do with this is to open a Neotree window which is\nfocused on the file under the cursor using the `` keyword:\n\n```\nnnoremap gd :Neotree float reveal_file= reveal_force_cwd\n```\n\n#### `reveal_force_cwd`\nThis is a boolean flag. Normally, if you use one of the reveal options and the\ngiven file is not within the current working directory, you will be asked if you\nwant to change the current working directory. If you include this flag, it will\nautomatically change the directory without prompting. This option implies\n\"reveal\", so you do not need to specify both.\n\n#### `selector`\nThis is a boolean flag. When you specifically set this to false (`selector=false`)\nneo-tree will disable the [source selector](#source-selector) for that neo-tree\ninstance. Otherwise, the source selector will depend on what you specified in\nthe configuration (`config.source_selector.{winbar,statusline}`).\n\nSee `:h neo-tree-commands` for details and a full listing of available arguments.\n\n### File Nesting\n\nSee `:h neo-tree-file-nesting` for more details about file nesting.\n\n\n### Netrw Hijack\n\n```\n:edit .\n:[v]split .\n```\n\nIf `\"filesystem.window.position\"` is set to `\"current\"`, or if you have specified\n`filesystem.hijack_netrw_behavior = \"open_current\"`, then any command\nthat would open a directory will open neo-tree in the specified window.\n\n\n## Sources\n\nNeo-tree is built on the idea of supporting various sources. Sources are\nbasically interface implementations whose job it is to provide a list of\nhierarchical items to be rendered, along with commands that are appropriate to\nthose items.\n\n### filesystem\nThe default source is `filesystem`, which displays your files and folders. This\nis the default source in commands when none is specified.\n\nThis source can be used to:\n- Browse the filesystem\n- Control the current working directory of nvim\n- Add/Copy/Delete/Move/Rename files and directories\n- Search the filesystem\n- Monitor git status and lsp diagnostics for the current working directory\n\n### buffers\n![Neo-tree buffers](https://github.com/nvim-neo-tree/resources/raw/main/images/Neo-tree-buffers.png)\n\nAnother available source is `buffers`, which displays your open buffers. This is\nthe same list you would see from `:ls`. To show with the `buffers` list, use:\n\n```\n:Neotree buffers\n```\n\n### git_status\nThis view take the results of the `git status` command and display them in a\ntree. It includes commands for adding, unstaging, reverting, and committing.\n\nThe screenshot below shows the result of `:Neotree float git_status` while the \nfilesystem is open in a sidebar:\n\n![Neo-tree git_status](https://github.com/nvim-neo-tree/resources/raw/main/images/Neo-tree-git_status.png)\n\nYou can specify a different git base here as well. But be aware that it is not\npossible to unstage / revert a file that is already committed.\n\n```\n:Neotree float git_status git_base=main\n```\n\n### document_symbols\n\n![Neo-tree document_symbols](https://github.com/nvim-neo-tree/resources/raw/main/images/neo-tree-document-symbols.png)\nThe document_symbols source lists the symbols in the current document obtained\nby the LSP request \"textDocument/documentSymbols\". It currently supports the\nfollowing features:\n- [x] UI:\n\t- [x] Display all symbols in the current file with symbol kinds\n\t- [x] Symbols nesting\n\t- [x] Configurable kinds' name and icon\n\t- [x] Auto-refresh symbol list\n - [x] Follow cursor\n- [ ] Commands\n\t- [x] Jump to symbols, open symbol in split,... (`open_split` and friends)\n\t- [x] Rename symbols (`rename`)\n\t- [x] Preview symbol (`preview` and friends)\n\t- [ ] Hover docs\n\t- [ ] Call hierarchy \n- [x] LSP\n - [x] LSP Support\n - [x] LSP server selection (ignore, allow_only, use first, use all, etc.)\n- [ ] CoC Support\n\nSee #879 for the tracking issue of these features.\n\nThis source is currently experimental, so in order to use it, you need to first \nadd `\"document_symbols\"` to `config.sources` and open it with the command\n```\n:Neotree document_symbols\n```\n\n### External Sources\n\nThere are more sources available as extensions that are managed outside of this repository. See the\n[wiki](https://github.com/nvim-neo-tree/neo-tree.nvim/wiki/External-Sources) for me information.\n\n### Source Selector\n\n![Neo-tree source selector](https://github.com/nvim-neo-tree/resources/raw/main/images/Neo-tree-source-selector.png)\n\nYou can enable a clickable source selector in either the winbar (requires neovim 0.8+) or the statusline.\nTo do so, set one of these options to `true`:\n\n```lua\n require(\"neo-tree\").setup({\n source_selector = {\n winbar = false,\n statusline = false\n }\n })\n```\n\nThere are many configuration options to change the style of these tabs. \nSee [lua/neo-tree/defaults.lua](lua/neo-tree/defaults.lua) for details.\n\n### Preview Mode\n\n`:h neo-tree-preview-mode`\n\nPreview mode will temporarily show whatever file the cursor is on without\nswitching focus from the Neo-tree window. By default, files will be previewed\nin a new floating window. This can also be configured to automatically choose\nan existing split by configuring the command like this:\n\n```lua\nrequire(\"neo-tree\").setup({\n window = {\n mappings = {\n [\"P\"] = { \"toggle_preview\", config = { use_float = false, use_image_nvim = true } },\n }\n }\n})\n```\n\nAnything that causes Neo-tree to lose focus will end preview mode. When\n`use_float = false`, the window that was taken over by preview mode will revert\nback to whatever was shown in that window before preview mode began.\n\nIf you want to work with the floating preview mode window in autocmds or other\ncustom code, the window will have the `neo-tree-preview` filetype.\n\nWhen preview mode is not using floats, the window will have the window local\nvariable `neo_tree_preview` set to `1` to indicate that it is being used as a\npreview window. You can refer to this in statusline and winbar configs to mark a\nwindow as being used as a preview.\n\n#### Image Support in Preview Mode\n\nIf you have [3rd/image.nvim](https://github.com/3rd/image.nvim) installed, preview\nmode supports image rendering by default using kitty graphics protocol or ueberzug\n([Video](https://user-images.githubusercontent.com/41065736/277180763-b7152637-f310-43a5-b8c3-4bcba135629d.mp4)).\nHowever, if you do not want this feature, you can disable it by changing the option\n`use_image_nvim = false` in the mappings config mentioned above.\n\n## Configuration and Customization\n\nThis is designed to be flexible. The way that is achieved is by making\neverything a function, or a string that identifies a built-in function. All of the\nbuilt-in functions can be replaced with your own implementation, or you can \nadd new ones.\n\nEach node in the tree is created from the renderer specified for the given node\ntype, and each renderer is a list of component configs to be rendered in order. \nEach component is a function, either built-in or specified in your config. Those\nfunctions simply return the text and highlight group for the component.\n\nAdditionally, there is an events system that you can hook into. If you want to\nshow some new data point related to your files, gather it in the\n`before_render` event, create a component to display it, and reference that\ncomponent in the renderer for the `file` and/or `directory` type.\n\nDetails on how to configure everything is in the help file at `:h\nneo-tree-configuration` or online at\n[neo-tree.txt](https://github.com/nvim-neo-tree/neo-tree.nvim/blob/main/doc/neo-tree.txt)\n\nRecipes for customizations can be found on the [wiki](https://github.com/nvim-neo-tree/neo-tree.nvim/wiki/Recipes). Recipes include\nthings like adding a component to show the\n[Harpoon](https://github.com/ThePrimeagen/harpoon) index for files, or\nresponding to the `\"file_opened\"` event to auto clear the search when you open a\nfile.\n\n\n## Why?\n\nThere are many tree plugins for (neo)vim, so why make another one? Well, I\nwanted something that was:\n\n1. Easy to maintain and enhance.\n2. Stable.\n3. Easy to customize.\n\n### Easy to maintain and enhance\n\nThis plugin is designed to grow and be flexible. This is accomplished by making\nthe code as decoupled and functional as possible. Hopefully new contributors\nwill find it easy to work with.\n\nOne big difference between this plugin and the ones that came before it, which\nis also what finally pushed me over the edge into making a new plugin, is that\nwe now have libraries to build upon that did not exist when other tree plugins\nwere created. Most notably, [nui.nvim](https://github.com/MunifTanjim/nui.nvim)\nand [plenary.nvm](https://github.com/nvim-lua/plenary.nvim). Building upon\nshared libraries will go a long way in making neo-tree easy to maintain.\n\n### Stable\n\nThis project will have releases and release tags that follow a simplified\nSemantic Versioning scheme. The quickstart instructions will always refer to\nthe latest stable major version. Following the **main** branch is for\ncontributors and those that always want bleeding edge. There will be branches\nfor **v1.x**, **v2.x**, etc which will receive updates after a short testing\nperiod in **main**. You should be safe to follow those branches and be sure\nyour tree won't break in an update. There will also be tags for each release\npushed to those branches named **v1.1**, **v1.2**, etc. If stability is\ncritical to you, or a bug accidentally make it into **v1.x**, you can use those\ntags instead. It's possible we may backport bug fixes to those tags, but no\ngarauntees on that.\n\nThere will never be a breaking change within a major version (1.x, 2.x, etc.) If\na breaking change is needed, there will be depracation warnings in the prior\nmajor version, and the breaking change will happen in the next major version.\n\n### Easy to Customize\n\nNeo-tree follows in the spirit of plugins like\n[lualine.nvim](https://github.com/nvim-lualine/lualine.nvim) and\n[nvim-cokeline](https://github.com/noib3/nvim-cokeline). Everything will be\nconfigurable and take either strings, tables, or functions. You can take sane\ndefaults or build your tree items from scratch. There should be the ability to\nadd any features you can think of through existing hooks in the setup function.\n\n## What is a Breaking Change?\n\nAs of v1.30, a breaking change is defined as anything that _changes_ existing:\n\n- vim commands (`:Neotree`)\n- configuration options that are passed into the `setup()` function\n- `NeoTree*` highlight groups\n- lua functions exported in the following modules that are not prefixed with `_`:\n * `neo-tree`\n * `neo-tree.events`\n * `neo-tree.sources.manager`\n * `neo-tree.sources.*` (init.lua files)\n * `neo-tree.sources.*.commands`\n * `neo-tree.ui.renderer`\n * `neo-tree.utils`\n\nIf there are other functions you would like to use that are not yet considered\npart of the public API, please open an issue so we can discuss it.\n\n## Contributions\n\nContributions are encouraged. Please see [CONTRIBUTING](CONTRIBUTING.md) for more details.\n\n## Acknowledgements\n\n### Maintainers\n\nFirst and foremost, this project is a community endeavor and would not survive without the constant stream of features\nand bug fixes that comes from that community. There have been many valued contributors, but a few have stepped up to\nbecome maintainers that generously donate their time to guide the project, help out others, and manage the issues. The\ncurrent list of maintainers are:\n\n(in alphabetical order)\n\n- @cseickel\n- @miversen33\n- @nhat-vo\n- @pysan3\n\n### Other Projects\n\nThis project relies upon these two excellent libraries:\n- [nui.nvim](https://github.com/MunifTanjim/nui.nvim) for all UI components, including the tree!\n- [plenary.nvim](https://github.com/nvim-lua/plenary.nvim) for backend utilities, such as scanning the filesystem.\n\nThe design is heavily inspired by these excellent plugins:\n- [lualine.nvim](https://github.com/nvim-lualine/lualine.nvim)\n- [nvim-cokeline](https://github.com/noib3/nvim-cokeline)\n\nEverything I know about writing a tree control in lua, I learned from:\n- [nvim-tree.lua](https://github.com/nvim-tree/nvim-tree.lua)\n","dotfyleShieldAddedAt":null,"stars":2246,"lastSyncedAt":"2023-11-29T02:19:57.183Z","addedLastWeek":3}}},{"id":"da190792-1dc7-48cc-b453-b536fb5604c8","title":"feat!: ignore disabled diagnostics (#1148)","text":"feat!: ignore disabled diagnostics (#1148)\n\nBREAKING CHANGE: lua `vim` global warnings are no longer ignored by neo-tree, this can be configured in the lsp config","type":"breaking-change","createdAt":"2023-09-17T02:14:17.542Z","breakingChange":{"id":44,"postId":"da190792-1dc7-48cc-b453-b536fb5604c8","pluginId":102,"externalUrl":"https://github.com/nvim-neo-tree/neo-tree.nvim/commit/e9edc00bdc9dd8e16ebef661fca0a50b35ddfb80","sha":"e9edc00bdc9dd8e16ebef661fca0a50b35ddfb80","plugin":{"id":102,"owner":"nvim-neo-tree","name":"neo-tree.nvim","type":"github","source":"awesome-neovim","category":"file-explorer","link":"https://github.com/nvim-neo-tree/neo-tree.nvim","shortDescription":"Neovim plugin to manage the file system and other tree like structures.","createdAt":"2023-03-22T19:35:21.577Z","readme":"# Neo-tree.nvim\n\nNeo-tree is a Neovim plugin to browse the file system and other tree like\nstructures in whatever style suits you, including sidebars, floating windows,\nnetrw split style, or all of them at once!\n\n### Neo-tree filesystem as Sidebar:\n\nThis screenshot shows Neo-tree opened in the traditional sidebar layout:\n\n![Neo-tree file system sidebar](https://github.com/nvim-neo-tree/resources/blob/main/images/Neo-tree-with-right-aligned-symbols.png)\n\n### Neo-tree filesystem Netrw Style\n\nThe below screenshot shows Neo-tree opened \"netrw style\" (`:Neotree position=current`). When opened in this way,\nthere is more room so the extra detail columns can be shown. This screenshot also shows how the contents can be\nsorted on any column. In this example, we are sorted on \"Size\" descending:\n\n![Neo-tree file system\ndetails](https://github.com/nvim-neo-tree/resources/blob/main/images/Neo-tree-with-file-details-and-sort.png)\n\n### Breaking Changes BAD :bomb: :imp:\n\nThe biggest and most important feature of Neo-tree is that we will never\nknowingly push a breaking change and interrupt your day. Bugs happen, but\nbreaking changes can always be avoided. When breaking changes are needed, there\nwill be a new branch that you can opt into, when it is a good time for you.\n\nSee [What is a Breaking Change?](#what-is-a-breaking-change) for details.\n\nSee [Changelog 3.0](https://github.com/nvim-neo-tree/neo-tree.nvim/wiki/Changelog#30)\nfor breaking changes and deprecations in 3.0.\n\n\n### User Experience GOOD :slightly_smiling_face: :thumbsup:\n\nAside from being polite about breaking changes, Neo-tree is also focused on the\nlittle details of user experience. Everything should work exactly as you would\nexpect a sidebar to work without all of the glitchy behavior that is normally\naccepted in (neo)vim sidebars. I can't stand glitchy behavior, and neither\nshould you!\n\n- Neo-tree won't let other buffers take over its window.\n- Neo-tree won't leave its window scrolled to the last line when there is\n plenty of room to display the whole tree.\n- Neo-tree does not need to be manually refreshed (set `use_libuv_file_watcher=true`)\n- Neo-tree can intelligently follow the current file (set `follow_current_file.enabled=true`)\n- Neo-tree is thoughtful about maintaining or setting focus on the right node\n- Neo-tree windows in different tabs are completely separate\n- `respect_gitignore` actually works!\n\nNeo-tree is smooth, efficient, stable, and pays attention to the little details.\nIf you find anything janky, wanky, broken, or unintuitive, please open an issue\nso we can fix it.\n\n\n## Minimal Quickstart\n\n#### Minimal Example for Lazy:\n```lua\n{\n \"nvim-neo-tree/neo-tree.nvim\",\n branch = \"v3.x\",\n dependencies = {\n \"nvim-lua/plenary.nvim\",\n \"nvim-tree/nvim-web-devicons\", -- not strictly required, but recommended\n \"MunifTanjim/nui.nvim\",\n -- \"3rd/image.nvim\", -- Optional image support in preview window: See `# Preview Mode` for more information\n }\n}\n```\n\n#### Minimal Example for Packer:\n```lua\nuse {\n \"nvim-neo-tree/neo-tree.nvim\",\n branch = \"v3.x\",\n requires = { \n \"nvim-lua/plenary.nvim\",\n \"nvim-tree/nvim-web-devicons\", -- not strictly required, but recommended\n \"MunifTanjim/nui.nvim\",\n -- \"3rd/image.nvim\", -- Optional image support in preview window: See `# Preview Mode` for more information\n }\n }\n```\n\nAfter installing, run:\n```\n:Neotree\n```\n\nPress `?` in the Neo-tree window to view the list of mappings.\n\n\n## Quickstart\n\n#### Longer Example for Packer:\n \n```lua\nuse {\n \"nvim-neo-tree/neo-tree.nvim\",\n branch = \"v3.x\",\n requires = { \n \"nvim-lua/plenary.nvim\",\n \"nvim-tree/nvim-web-devicons\", -- not strictly required, but recommended\n \"MunifTanjim/nui.nvim\",\n -- \"3rd/image.nvim\", -- Optional image support in preview window: See `# Preview Mode` for more information\n {\n 's1n7ax/nvim-window-picker',\n version = '2.*',\n config = function()\n require 'window-picker'.setup({\n filter_rules = {\n include_current_win = false,\n autoselect_one = true,\n -- filter using buffer options\n bo = {\n -- if the file type is one of following, the window will be ignored\n filetype = { 'neo-tree', \"neo-tree-popup\", \"notify\" },\n -- if the buffer type is one of following, the window will be ignored\n buftype = { 'terminal', \"quickfix\" },\n },\n },\n })\n end,\n },\n },\n config = function ()\n -- If you want icons for diagnostic errors, you'll need to define them somewhere:\n vim.fn.sign_define(\"DiagnosticSignError\",\n {text = \" \", texthl = \"DiagnosticSignError\"})\n vim.fn.sign_define(\"DiagnosticSignWarn\",\n {text = \" \", texthl = \"DiagnosticSignWarn\"})\n vim.fn.sign_define(\"DiagnosticSignInfo\",\n {text = \" \", texthl = \"DiagnosticSignInfo\"})\n vim.fn.sign_define(\"DiagnosticSignHint\",\n {text = \"󰌵\", texthl = \"DiagnosticSignHint\"})\n\n require(\"neo-tree\").setup({\n close_if_last_window = false, -- Close Neo-tree if it is the last window left in the tab\n popup_border_style = \"rounded\",\n enable_git_status = true,\n enable_diagnostics = true,\n enable_normal_mode_for_inputs = false, -- Enable normal mode for input dialogs.\n open_files_do_not_replace_types = { \"terminal\", \"trouble\", \"qf\" }, -- when opening files, do not use windows containing these filetypes or buftypes\n sort_case_insensitive = false, -- used when sorting files and directories in the tree\n sort_function = nil , -- use a custom function for sorting files and directories in the tree \n -- sort_function = function (a,b)\n -- if a.type == b.type then\n -- return a.path > b.path\n -- else\n -- return a.type > b.type\n -- end\n -- end , -- this sorts files and directories descendantly\n default_component_configs = {\n container = {\n enable_character_fade = true\n },\n indent = {\n indent_size = 2,\n padding = 1, -- extra padding on left hand side\n -- indent guides\n with_markers = true,\n indent_marker = \"│\",\n last_indent_marker = \"└\",\n highlight = \"NeoTreeIndentMarker\",\n -- expander config, needed for nesting files\n with_expanders = nil, -- if nil and file nesting is enabled, will enable expanders\n expander_collapsed = \"\",\n expander_expanded = \"\",\n expander_highlight = \"NeoTreeExpander\",\n },\n icon = {\n folder_closed = \"\",\n folder_open = \"\",\n folder_empty = \"󰜌\",\n -- The next two settings are only a fallback, if you use nvim-web-devicons and configure default icons there\n -- then these will never be used.\n default = \"*\",\n highlight = \"NeoTreeFileIcon\"\n },\n modified = {\n symbol = \"[+]\",\n highlight = \"NeoTreeModified\",\n },\n name = {\n trailing_slash = false,\n use_git_status_colors = true,\n highlight = \"NeoTreeFileName\",\n },\n git_status = {\n symbols = {\n -- Change type\n added = \"\", -- or \"✚\", but this is redundant info if you use git_status_colors on the name\n modified = \"\", -- or \"\", but this is redundant info if you use git_status_colors on the name\n deleted = \"✖\",-- this can only be used in the git_status source\n renamed = \"󰁕\",-- this can only be used in the git_status source\n -- Status type\n untracked = \"\",\n ignored = \"\",\n unstaged = \"󰄱\",\n staged = \"\",\n conflict = \"\",\n }\n },\n -- If you don't want to use these columns, you can set `enabled = false` for each of them individually\n file_size = {\n enabled = true,\n required_width = 64, -- min width of window required to show this column\n },\n type = {\n enabled = true,\n required_width = 122, -- min width of window required to show this column\n },\n last_modified = {\n enabled = true,\n required_width = 88, -- min width of window required to show this column\n },\n created = {\n enabled = true,\n required_width = 110, -- min width of window required to show this column\n },\n symlink_target = {\n enabled = false,\n },\n },\n -- A list of functions, each representing a global custom command\n -- that will be available in all sources (if not overridden in `opts[source_name].commands`)\n -- see `:h neo-tree-custom-commands-global`\n commands = {},\n window = {\n position = \"left\",\n width = 40,\n mapping_options = {\n noremap = true,\n nowait = true,\n },\n mappings = {\n [\"\"] = { \n \"toggle_node\", \n nowait = false, -- disable `nowait` if you have existing combos starting with this char that you want to use \n },\n [\"<2-LeftMouse>\"] = \"open\",\n [\"\"] = \"open\",\n [\"\"] = \"cancel\", -- close preview or floating neo-tree window\n [\"P\"] = { \"toggle_preview\", config = { use_float = true, use_image_nvim = true } },\n -- Read `# Preview Mode` for more information\n [\"l\"] = \"focus_preview\",\n [\"S\"] = \"open_split\",\n [\"s\"] = \"open_vsplit\",\n -- [\"S\"] = \"split_with_window_picker\",\n -- [\"s\"] = \"vsplit_with_window_picker\",\n [\"t\"] = \"open_tabnew\",\n -- [\"\"] = \"open_drop\",\n -- [\"t\"] = \"open_tab_drop\",\n [\"w\"] = \"open_with_window_picker\",\n --[\"P\"] = \"toggle_preview\", -- enter preview mode, which shows the current node without focusing\n [\"C\"] = \"close_node\",\n -- ['C'] = 'close_all_subnodes',\n [\"z\"] = \"close_all_nodes\",\n --[\"Z\"] = \"expand_all_nodes\",\n [\"a\"] = { \n \"add\",\n -- this command supports BASH style brace expansion (\"x{a,b,c}\" -> xa,xb,xc). see `:h neo-tree-file-actions` for details\n -- some commands may take optional config options, see `:h neo-tree-mappings` for details\n config = {\n show_path = \"none\" -- \"none\", \"relative\", \"absolute\"\n }\n },\n [\"A\"] = \"add_directory\", -- also accepts the optional config.show_path option like \"add\". this also supports BASH style brace expansion.\n [\"d\"] = \"delete\",\n [\"r\"] = \"rename\",\n [\"y\"] = \"copy_to_clipboard\",\n [\"x\"] = \"cut_to_clipboard\",\n [\"p\"] = \"paste_from_clipboard\",\n [\"c\"] = \"copy\", -- takes text input for destination, also accepts the optional config.show_path option like \"add\":\n -- [\"c\"] = {\n -- \"copy\",\n -- config = {\n -- show_path = \"none\" -- \"none\", \"relative\", \"absolute\"\n -- }\n --}\n [\"m\"] = \"move\", -- takes text input for destination, also accepts the optional config.show_path option like \"add\".\n [\"q\"] = \"close_window\",\n [\"R\"] = \"refresh\",\n [\"?\"] = \"show_help\",\n [\"<\"] = \"prev_source\",\n [\">\"] = \"next_source\",\n [\"i\"] = \"show_file_details\",\n }\n },\n nesting_rules = {},\n filesystem = {\n filtered_items = {\n visible = false, -- when true, they will just be displayed differently than normal items\n hide_dotfiles = true,\n hide_gitignored = true,\n hide_hidden = true, -- only works on Windows for hidden files/directories\n hide_by_name = {\n --\"node_modules\"\n },\n hide_by_pattern = { -- uses glob style patterns\n --\"*.meta\",\n --\"*/src/*/tsconfig.json\",\n },\n always_show = { -- remains visible even if other settings would normally hide it\n --\".gitignored\",\n },\n never_show = { -- remains hidden even if visible is toggled to true, this overrides always_show\n --\".DS_Store\",\n --\"thumbs.db\"\n },\n never_show_by_pattern = { -- uses glob style patterns\n --\".null-ls_*\",\n },\n },\n follow_current_file = {\n enabled = false, -- This will find and focus the file in the active buffer every time\n -- -- the current file is changed while the tree is open.\n leave_dirs_open = false, -- `false` closes auto expanded dirs, such as with `:Neotree reveal`\n },\n group_empty_dirs = false, -- when true, empty folders will be grouped together\n hijack_netrw_behavior = \"open_default\", -- netrw disabled, opening a directory opens neo-tree\n -- in whatever position is specified in window.position\n -- \"open_current\", -- netrw disabled, opening a directory opens within the\n -- window like netrw would, regardless of window.position\n -- \"disabled\", -- netrw left alone, neo-tree does not handle opening dirs\n use_libuv_file_watcher = false, -- This will use the OS level file watchers to detect changes\n -- instead of relying on nvim autocmd events.\n window = {\n mappings = {\n [\"\"] = \"navigate_up\",\n [\".\"] = \"set_root\",\n [\"H\"] = \"toggle_hidden\",\n [\"/\"] = \"fuzzy_finder\",\n [\"D\"] = \"fuzzy_finder_directory\",\n [\"#\"] = \"fuzzy_sorter\", -- fuzzy sorting using the fzy algorithm\n -- [\"D\"] = \"fuzzy_sorter_directory\",\n [\"f\"] = \"filter_on_submit\",\n [\"\"] = \"clear_filter\",\n [\"[g\"] = \"prev_git_modified\",\n [\"]g\"] = \"next_git_modified\",\n [\"o\"] = { \"show_help\", nowait=false, config = { title = \"Order by\", prefix_key = \"o\" }},\n [\"oc\"] = { \"order_by_created\", nowait = false },\n [\"od\"] = { \"order_by_diagnostics\", nowait = false },\n [\"og\"] = { \"order_by_git_status\", nowait = false },\n [\"om\"] = { \"order_by_modified\", nowait = false },\n [\"on\"] = { \"order_by_name\", nowait = false },\n [\"os\"] = { \"order_by_size\", nowait = false },\n [\"ot\"] = { \"order_by_type\", nowait = false },\n },\n fuzzy_finder_mappings = { -- define keymaps for filter popup window in fuzzy_finder_mode\n [\"\"] = \"move_cursor_down\",\n [\"\"] = \"move_cursor_down\",\n [\"\"] = \"move_cursor_up\",\n [\"\"] = \"move_cursor_up\",\n },\n },\n\n commands = {} -- Add a custom command or override a global one using the same function name\n },\n buffers = {\n follow_current_file = {\n enabled = true, -- This will find and focus the file in the active buffer every time\n -- -- the current file is changed while the tree is open.\n leave_dirs_open = false, -- `false` closes auto expanded dirs, such as with `:Neotree reveal`\n },\n group_empty_dirs = true, -- when true, empty folders will be grouped together\n show_unloaded = true,\n window = {\n mappings = {\n [\"bd\"] = \"buffer_delete\",\n [\"\"] = \"navigate_up\",\n [\".\"] = \"set_root\",\n [\"o\"] = { \"show_help\", nowait=false, config = { title = \"Order by\", prefix_key = \"o\" }},\n [\"oc\"] = { \"order_by_created\", nowait = false },\n [\"od\"] = { \"order_by_diagnostics\", nowait = false },\n [\"om\"] = { \"order_by_modified\", nowait = false },\n [\"on\"] = { \"order_by_name\", nowait = false },\n [\"os\"] = { \"order_by_size\", nowait = false },\n [\"ot\"] = { \"order_by_type\", nowait = false },\n }\n },\n },\n git_status = {\n window = {\n position = \"float\",\n mappings = {\n [\"A\"] = \"git_add_all\",\n [\"gu\"] = \"git_unstage_file\",\n [\"ga\"] = \"git_add_file\",\n [\"gr\"] = \"git_revert_file\",\n [\"gc\"] = \"git_commit\",\n [\"gp\"] = \"git_push\",\n [\"gg\"] = \"git_commit_and_push\",\n [\"o\"] = { \"show_help\", nowait=false, config = { title = \"Order by\", prefix_key = \"o\" }},\n [\"oc\"] = { \"order_by_created\", nowait = false },\n [\"od\"] = { \"order_by_diagnostics\", nowait = false },\n [\"om\"] = { \"order_by_modified\", nowait = false },\n [\"on\"] = { \"order_by_name\", nowait = false },\n [\"os\"] = { \"order_by_size\", nowait = false },\n [\"ot\"] = { \"order_by_type\", nowait = false },\n }\n }\n }\n })\n\n vim.cmd([[nnoremap \\ :Neotree reveal]])\n end\n}\n```\n\n_The above configuration is not everything that can be changed, it's just the\nparts you might want to change first._\n\n\nSee `:h neo-tree` for full documentation. You can also preview that online at\n[doc/neo-tree.txt](doc/neo-tree.txt), although it's best viewed within vim.\n\n\nTo see all of the default config options with commentary, you can view it online\nat [lua/neo-tree/defaults.lua](lua/neo-tree/defaults.lua). You can also paste it\ninto a buffer after installing Neo-tree by running: \n\n```\n:lua require(\"neo-tree\").paste_default_config()\n```\n\n## The `:Neotree` Command\n\nThe single `:Neotree` command accepts a range of arguments that give you full\ncontrol over the details of what and where it will show. For example, the following \ncommand will open a file browser on the right hand side, \"revealing\" the currently\nactive file:\n\n```\n:Neotree filesystem reveal right\n```\n\nArguments can be specified as either a key=value pair or just as the value. The\nkey=value form is more verbose but may help with clarity. For example, the command\nabove can also be specified as:\n\n```\n:Neotree source=filesystem reveal=true position=right\n```\n\nAll arguments are optional and can be specified in any order. If you issue the command\nwithout any arguments, it will use default values for everything. For example:\n\n```\n:Neotree\n```\n\nwill open the filesystem source on the left hand side and focus it, if you are using \nthe default config.\n\n### Tab Completion\n\nNeotree supports tab completion for all arguments. Once a given argument has a value,\nit will stop suggesting those completions. It will also offer completions for paths.\nThe simplest way to disambiguate a path from another type of argument is to start\nthem with `/` or `./`.\n\n### Arguments\n\nHere is the full list of arguments you can use:\n\n#### `action`\nWhat to do. Can be one of:\n\n| Option | Description |\n|--------|-------------|\n| focus | Show and/or switch focus to the specified Neotree window. DEFAULT |\n| show | Show the window, but keep focus on your current window. |\n| close | Close the window(s) specified. Can be combined with \"position\" and/or \"source\" to specify which window(s) to close. |\n\n#### `source`\nWhat to show. Can be one of:\n\n| Option | Description |\n|--------|-------------|\n| filesystem | Show a file browser. DEFAULT |\n| buffers | Show a list of currently open buffers. |\n| git_status | Show the output of `git status` in a tree layout. |\n| last | Equivalent to the last source used |\n\n#### `position`\nWhere to show it, can be one of:\n\n| Option | Description |\n|---------|-------------|\n| left | Open as left hand sidebar. DEFAULT |\n| right | Open as right hand sidebar. |\n| top | Open as top window. |\n| bottom | Open as bottom window. |\n| float | Open as floating window. |\n| current | Open within the current window, like netrw or vinegar would. |\n\n#### `toggle`\nThis is a boolean flag. Adding this means that the window will be closed if it\nis already open.\n\n#### `dir`\nThe directory to set as the root/cwd of the specified window. If you include a\ndirectory as one of the arguments, it will be assumed to be this option, you\ndon't need the full dir=/path. You may use any value that can be passed to the\n'expand' function, such as `%:p:h:h` to specify two directories up from the\ncurrent file. For example:\n\n```\n:Neotree ./relative/path\n:Neotree /home/user/relative/path\n:Neotree dir=/home/user/relative/path\n:Neotree position=current dir=relative/path\n```\n\n#### `git_base`\nThe base that is used to calculate the git status for each dir/file.\nBy default it uses `HEAD`, so it shows all changes that are not yet committed.\nYou can for example work on a feature branch, and set it to `main`. It will\nshow all changes that happened on the feature branch and main since you \nbranched off.\n\nAny git ref, commit, tag, or sha will work.\n\n```\n:Neotree main\n:Neotree v1.0\n:Neotree git_base=8fe34be\n:Neotree git_base=HEAD\n```\n\n#### `reveal`\nThis is a boolean flag. Adding this will make Neotree automatically find and \nfocus the current file when it opens.\n\n#### `reveal_file`\nA path to a file to reveal. This supersedes the \"reveal\" flag so there is no\nneed to specify both. Use this if you want to reveal something other than the\ncurrent file. If you include a path to a file as one of the arguments, it will\nbe assumed to be this option. Like \"dir\", you can pass any value that can be\npassed to the 'expand' function. For example:\n\n```\n:Neotree reveal_file=/home/user/my/file.text\n:Neotree position=current dir=%:p:h:h reveal_file=%:p\n:Neotree current %:p:h:h %:p\n```\n\nOne neat trick you can do with this is to open a Neotree window which is\nfocused on the file under the cursor using the `` keyword:\n\n```\nnnoremap gd :Neotree float reveal_file= reveal_force_cwd\n```\n\n#### `reveal_force_cwd`\nThis is a boolean flag. Normally, if you use one of the reveal options and the\ngiven file is not within the current working directory, you will be asked if you\nwant to change the current working directory. If you include this flag, it will\nautomatically change the directory without prompting. This option implies\n\"reveal\", so you do not need to specify both.\n\n#### `selector`\nThis is a boolean flag. When you specifically set this to false (`selector=false`)\nneo-tree will disable the [source selector](#source-selector) for that neo-tree\ninstance. Otherwise, the source selector will depend on what you specified in\nthe configuration (`config.source_selector.{winbar,statusline}`).\n\nSee `:h neo-tree-commands` for details and a full listing of available arguments.\n\n### File Nesting\n\nSee `:h neo-tree-file-nesting` for more details about file nesting.\n\n\n### Netrw Hijack\n\n```\n:edit .\n:[v]split .\n```\n\nIf `\"filesystem.window.position\"` is set to `\"current\"`, or if you have specified\n`filesystem.hijack_netrw_behavior = \"open_current\"`, then any command\nthat would open a directory will open neo-tree in the specified window.\n\n\n## Sources\n\nNeo-tree is built on the idea of supporting various sources. Sources are\nbasically interface implementations whose job it is to provide a list of\nhierarchical items to be rendered, along with commands that are appropriate to\nthose items.\n\n### filesystem\nThe default source is `filesystem`, which displays your files and folders. This\nis the default source in commands when none is specified.\n\nThis source can be used to:\n- Browse the filesystem\n- Control the current working directory of nvim\n- Add/Copy/Delete/Move/Rename files and directories\n- Search the filesystem\n- Monitor git status and lsp diagnostics for the current working directory\n\n### buffers\n![Neo-tree buffers](https://github.com/nvim-neo-tree/resources/raw/main/images/Neo-tree-buffers.png)\n\nAnother available source is `buffers`, which displays your open buffers. This is\nthe same list you would see from `:ls`. To show with the `buffers` list, use:\n\n```\n:Neotree buffers\n```\n\n### git_status\nThis view take the results of the `git status` command and display them in a\ntree. It includes commands for adding, unstaging, reverting, and committing.\n\nThe screenshot below shows the result of `:Neotree float git_status` while the \nfilesystem is open in a sidebar:\n\n![Neo-tree git_status](https://github.com/nvim-neo-tree/resources/raw/main/images/Neo-tree-git_status.png)\n\nYou can specify a different git base here as well. But be aware that it is not\npossible to unstage / revert a file that is already committed.\n\n```\n:Neotree float git_status git_base=main\n```\n\n### document_symbols\n\n![Neo-tree document_symbols](https://github.com/nvim-neo-tree/resources/raw/main/images/neo-tree-document-symbols.png)\nThe document_symbols source lists the symbols in the current document obtained\nby the LSP request \"textDocument/documentSymbols\". It currently supports the\nfollowing features:\n- [x] UI:\n\t- [x] Display all symbols in the current file with symbol kinds\n\t- [x] Symbols nesting\n\t- [x] Configurable kinds' name and icon\n\t- [x] Auto-refresh symbol list\n - [x] Follow cursor\n- [ ] Commands\n\t- [x] Jump to symbols, open symbol in split,... (`open_split` and friends)\n\t- [x] Rename symbols (`rename`)\n\t- [x] Preview symbol (`preview` and friends)\n\t- [ ] Hover docs\n\t- [ ] Call hierarchy \n- [x] LSP\n - [x] LSP Support\n - [x] LSP server selection (ignore, allow_only, use first, use all, etc.)\n- [ ] CoC Support\n\nSee #879 for the tracking issue of these features.\n\nThis source is currently experimental, so in order to use it, you need to first \nadd `\"document_symbols\"` to `config.sources` and open it with the command\n```\n:Neotree document_symbols\n```\n\n### External Sources\n\nThere are more sources available as extensions that are managed outside of this repository. See the\n[wiki](https://github.com/nvim-neo-tree/neo-tree.nvim/wiki/External-Sources) for me information.\n\n### Source Selector\n\n![Neo-tree source selector](https://github.com/nvim-neo-tree/resources/raw/main/images/Neo-tree-source-selector.png)\n\nYou can enable a clickable source selector in either the winbar (requires neovim 0.8+) or the statusline.\nTo do so, set one of these options to `true`:\n\n```lua\n require(\"neo-tree\").setup({\n source_selector = {\n winbar = false,\n statusline = false\n }\n })\n```\n\nThere are many configuration options to change the style of these tabs. \nSee [lua/neo-tree/defaults.lua](lua/neo-tree/defaults.lua) for details.\n\n### Preview Mode\n\n`:h neo-tree-preview-mode`\n\nPreview mode will temporarily show whatever file the cursor is on without\nswitching focus from the Neo-tree window. By default, files will be previewed\nin a new floating window. This can also be configured to automatically choose\nan existing split by configuring the command like this:\n\n```lua\nrequire(\"neo-tree\").setup({\n window = {\n mappings = {\n [\"P\"] = { \"toggle_preview\", config = { use_float = false, use_image_nvim = true } },\n }\n }\n})\n```\n\nAnything that causes Neo-tree to lose focus will end preview mode. When\n`use_float = false`, the window that was taken over by preview mode will revert\nback to whatever was shown in that window before preview mode began.\n\nIf you want to work with the floating preview mode window in autocmds or other\ncustom code, the window will have the `neo-tree-preview` filetype.\n\nWhen preview mode is not using floats, the window will have the window local\nvariable `neo_tree_preview` set to `1` to indicate that it is being used as a\npreview window. You can refer to this in statusline and winbar configs to mark a\nwindow as being used as a preview.\n\n#### Image Support in Preview Mode\n\nIf you have [3rd/image.nvim](https://github.com/3rd/image.nvim) installed, preview\nmode supports image rendering by default using kitty graphics protocol or ueberzug\n([Video](https://user-images.githubusercontent.com/41065736/277180763-b7152637-f310-43a5-b8c3-4bcba135629d.mp4)).\nHowever, if you do not want this feature, you can disable it by changing the option\n`use_image_nvim = false` in the mappings config mentioned above.\n\n## Configuration and Customization\n\nThis is designed to be flexible. The way that is achieved is by making\neverything a function, or a string that identifies a built-in function. All of the\nbuilt-in functions can be replaced with your own implementation, or you can \nadd new ones.\n\nEach node in the tree is created from the renderer specified for the given node\ntype, and each renderer is a list of component configs to be rendered in order. \nEach component is a function, either built-in or specified in your config. Those\nfunctions simply return the text and highlight group for the component.\n\nAdditionally, there is an events system that you can hook into. If you want to\nshow some new data point related to your files, gather it in the\n`before_render` event, create a component to display it, and reference that\ncomponent in the renderer for the `file` and/or `directory` type.\n\nDetails on how to configure everything is in the help file at `:h\nneo-tree-configuration` or online at\n[neo-tree.txt](https://github.com/nvim-neo-tree/neo-tree.nvim/blob/main/doc/neo-tree.txt)\n\nRecipes for customizations can be found on the [wiki](https://github.com/nvim-neo-tree/neo-tree.nvim/wiki/Recipes). Recipes include\nthings like adding a component to show the\n[Harpoon](https://github.com/ThePrimeagen/harpoon) index for files, or\nresponding to the `\"file_opened\"` event to auto clear the search when you open a\nfile.\n\n\n## Why?\n\nThere are many tree plugins for (neo)vim, so why make another one? Well, I\nwanted something that was:\n\n1. Easy to maintain and enhance.\n2. Stable.\n3. Easy to customize.\n\n### Easy to maintain and enhance\n\nThis plugin is designed to grow and be flexible. This is accomplished by making\nthe code as decoupled and functional as possible. Hopefully new contributors\nwill find it easy to work with.\n\nOne big difference between this plugin and the ones that came before it, which\nis also what finally pushed me over the edge into making a new plugin, is that\nwe now have libraries to build upon that did not exist when other tree plugins\nwere created. Most notably, [nui.nvim](https://github.com/MunifTanjim/nui.nvim)\nand [plenary.nvm](https://github.com/nvim-lua/plenary.nvim). Building upon\nshared libraries will go a long way in making neo-tree easy to maintain.\n\n### Stable\n\nThis project will have releases and release tags that follow a simplified\nSemantic Versioning scheme. The quickstart instructions will always refer to\nthe latest stable major version. Following the **main** branch is for\ncontributors and those that always want bleeding edge. There will be branches\nfor **v1.x**, **v2.x**, etc which will receive updates after a short testing\nperiod in **main**. You should be safe to follow those branches and be sure\nyour tree won't break in an update. There will also be tags for each release\npushed to those branches named **v1.1**, **v1.2**, etc. If stability is\ncritical to you, or a bug accidentally make it into **v1.x**, you can use those\ntags instead. It's possible we may backport bug fixes to those tags, but no\ngarauntees on that.\n\nThere will never be a breaking change within a major version (1.x, 2.x, etc.) If\na breaking change is needed, there will be depracation warnings in the prior\nmajor version, and the breaking change will happen in the next major version.\n\n### Easy to Customize\n\nNeo-tree follows in the spirit of plugins like\n[lualine.nvim](https://github.com/nvim-lualine/lualine.nvim) and\n[nvim-cokeline](https://github.com/noib3/nvim-cokeline). Everything will be\nconfigurable and take either strings, tables, or functions. You can take sane\ndefaults or build your tree items from scratch. There should be the ability to\nadd any features you can think of through existing hooks in the setup function.\n\n## What is a Breaking Change?\n\nAs of v1.30, a breaking change is defined as anything that _changes_ existing:\n\n- vim commands (`:Neotree`)\n- configuration options that are passed into the `setup()` function\n- `NeoTree*` highlight groups\n- lua functions exported in the following modules that are not prefixed with `_`:\n * `neo-tree`\n * `neo-tree.events`\n * `neo-tree.sources.manager`\n * `neo-tree.sources.*` (init.lua files)\n * `neo-tree.sources.*.commands`\n * `neo-tree.ui.renderer`\n * `neo-tree.utils`\n\nIf there are other functions you would like to use that are not yet considered\npart of the public API, please open an issue so we can discuss it.\n\n## Contributions\n\nContributions are encouraged. Please see [CONTRIBUTING](CONTRIBUTING.md) for more details.\n\n## Acknowledgements\n\n### Maintainers\n\nFirst and foremost, this project is a community endeavor and would not survive without the constant stream of features\nand bug fixes that comes from that community. There have been many valued contributors, but a few have stepped up to\nbecome maintainers that generously donate their time to guide the project, help out others, and manage the issues. The\ncurrent list of maintainers are:\n\n(in alphabetical order)\n\n- @cseickel\n- @miversen33\n- @nhat-vo\n- @pysan3\n\n### Other Projects\n\nThis project relies upon these two excellent libraries:\n- [nui.nvim](https://github.com/MunifTanjim/nui.nvim) for all UI components, including the tree!\n- [plenary.nvim](https://github.com/nvim-lua/plenary.nvim) for backend utilities, such as scanning the filesystem.\n\nThe design is heavily inspired by these excellent plugins:\n- [lualine.nvim](https://github.com/nvim-lualine/lualine.nvim)\n- [nvim-cokeline](https://github.com/noib3/nvim-cokeline)\n\nEverything I know about writing a tree control in lua, I learned from:\n- [nvim-tree.lua](https://github.com/nvim-tree/nvim-tree.lua)\n","dotfyleShieldAddedAt":null,"stars":2246,"lastSyncedAt":"2023-11-29T02:19:57.183Z","addedLastWeek":3}}},{"id":"fad785ae-44d5-4f1d-a7fd-0fffa1305b4a","title":"refactor!: enable the `symlink_target` component using `default_component_configs` (#1122)","text":"refactor!: enable the `symlink_target` component using `default_component_configs` (#1122)","type":"breaking-change","createdAt":"2023-08-28T02:12:52.602Z","breakingChange":{"id":37,"postId":"fad785ae-44d5-4f1d-a7fd-0fffa1305b4a","pluginId":102,"externalUrl":"https://github.com/nvim-neo-tree/neo-tree.nvim/commit/8602bfaa0299ab7b1e938240d5ef2f893f48cca5","sha":"8602bfaa0299ab7b1e938240d5ef2f893f48cca5","plugin":{"id":102,"owner":"nvim-neo-tree","name":"neo-tree.nvim","type":"github","source":"awesome-neovim","category":"file-explorer","link":"https://github.com/nvim-neo-tree/neo-tree.nvim","shortDescription":"Neovim plugin to manage the file system and other tree like structures.","createdAt":"2023-03-22T19:35:21.577Z","readme":"# Neo-tree.nvim\n\nNeo-tree is a Neovim plugin to browse the file system and other tree like\nstructures in whatever style suits you, including sidebars, floating windows,\nnetrw split style, or all of them at once!\n\n### Neo-tree filesystem as Sidebar:\n\nThis screenshot shows Neo-tree opened in the traditional sidebar layout:\n\n![Neo-tree file system sidebar](https://github.com/nvim-neo-tree/resources/blob/main/images/Neo-tree-with-right-aligned-symbols.png)\n\n### Neo-tree filesystem Netrw Style\n\nThe below screenshot shows Neo-tree opened \"netrw style\" (`:Neotree position=current`). When opened in this way,\nthere is more room so the extra detail columns can be shown. This screenshot also shows how the contents can be\nsorted on any column. In this example, we are sorted on \"Size\" descending:\n\n![Neo-tree file system\ndetails](https://github.com/nvim-neo-tree/resources/blob/main/images/Neo-tree-with-file-details-and-sort.png)\n\n### Breaking Changes BAD :bomb: :imp:\n\nThe biggest and most important feature of Neo-tree is that we will never\nknowingly push a breaking change and interrupt your day. Bugs happen, but\nbreaking changes can always be avoided. When breaking changes are needed, there\nwill be a new branch that you can opt into, when it is a good time for you.\n\nSee [What is a Breaking Change?](#what-is-a-breaking-change) for details.\n\nSee [Changelog 3.0](https://github.com/nvim-neo-tree/neo-tree.nvim/wiki/Changelog#30)\nfor breaking changes and deprecations in 3.0.\n\n\n### User Experience GOOD :slightly_smiling_face: :thumbsup:\n\nAside from being polite about breaking changes, Neo-tree is also focused on the\nlittle details of user experience. Everything should work exactly as you would\nexpect a sidebar to work without all of the glitchy behavior that is normally\naccepted in (neo)vim sidebars. I can't stand glitchy behavior, and neither\nshould you!\n\n- Neo-tree won't let other buffers take over its window.\n- Neo-tree won't leave its window scrolled to the last line when there is\n plenty of room to display the whole tree.\n- Neo-tree does not need to be manually refreshed (set `use_libuv_file_watcher=true`)\n- Neo-tree can intelligently follow the current file (set `follow_current_file.enabled=true`)\n- Neo-tree is thoughtful about maintaining or setting focus on the right node\n- Neo-tree windows in different tabs are completely separate\n- `respect_gitignore` actually works!\n\nNeo-tree is smooth, efficient, stable, and pays attention to the little details.\nIf you find anything janky, wanky, broken, or unintuitive, please open an issue\nso we can fix it.\n\n\n## Minimal Quickstart\n\n#### Minimal Example for Lazy:\n```lua\n{\n \"nvim-neo-tree/neo-tree.nvim\",\n branch = \"v3.x\",\n dependencies = {\n \"nvim-lua/plenary.nvim\",\n \"nvim-tree/nvim-web-devicons\", -- not strictly required, but recommended\n \"MunifTanjim/nui.nvim\",\n -- \"3rd/image.nvim\", -- Optional image support in preview window: See `# Preview Mode` for more information\n }\n}\n```\n\n#### Minimal Example for Packer:\n```lua\nuse {\n \"nvim-neo-tree/neo-tree.nvim\",\n branch = \"v3.x\",\n requires = { \n \"nvim-lua/plenary.nvim\",\n \"nvim-tree/nvim-web-devicons\", -- not strictly required, but recommended\n \"MunifTanjim/nui.nvim\",\n -- \"3rd/image.nvim\", -- Optional image support in preview window: See `# Preview Mode` for more information\n }\n }\n```\n\nAfter installing, run:\n```\n:Neotree\n```\n\nPress `?` in the Neo-tree window to view the list of mappings.\n\n\n## Quickstart\n\n#### Longer Example for Packer:\n \n```lua\nuse {\n \"nvim-neo-tree/neo-tree.nvim\",\n branch = \"v3.x\",\n requires = { \n \"nvim-lua/plenary.nvim\",\n \"nvim-tree/nvim-web-devicons\", -- not strictly required, but recommended\n \"MunifTanjim/nui.nvim\",\n -- \"3rd/image.nvim\", -- Optional image support in preview window: See `# Preview Mode` for more information\n {\n 's1n7ax/nvim-window-picker',\n version = '2.*',\n config = function()\n require 'window-picker'.setup({\n filter_rules = {\n include_current_win = false,\n autoselect_one = true,\n -- filter using buffer options\n bo = {\n -- if the file type is one of following, the window will be ignored\n filetype = { 'neo-tree', \"neo-tree-popup\", \"notify\" },\n -- if the buffer type is one of following, the window will be ignored\n buftype = { 'terminal', \"quickfix\" },\n },\n },\n })\n end,\n },\n },\n config = function ()\n -- If you want icons for diagnostic errors, you'll need to define them somewhere:\n vim.fn.sign_define(\"DiagnosticSignError\",\n {text = \" \", texthl = \"DiagnosticSignError\"})\n vim.fn.sign_define(\"DiagnosticSignWarn\",\n {text = \" \", texthl = \"DiagnosticSignWarn\"})\n vim.fn.sign_define(\"DiagnosticSignInfo\",\n {text = \" \", texthl = \"DiagnosticSignInfo\"})\n vim.fn.sign_define(\"DiagnosticSignHint\",\n {text = \"󰌵\", texthl = \"DiagnosticSignHint\"})\n\n require(\"neo-tree\").setup({\n close_if_last_window = false, -- Close Neo-tree if it is the last window left in the tab\n popup_border_style = \"rounded\",\n enable_git_status = true,\n enable_diagnostics = true,\n enable_normal_mode_for_inputs = false, -- Enable normal mode for input dialogs.\n open_files_do_not_replace_types = { \"terminal\", \"trouble\", \"qf\" }, -- when opening files, do not use windows containing these filetypes or buftypes\n sort_case_insensitive = false, -- used when sorting files and directories in the tree\n sort_function = nil , -- use a custom function for sorting files and directories in the tree \n -- sort_function = function (a,b)\n -- if a.type == b.type then\n -- return a.path > b.path\n -- else\n -- return a.type > b.type\n -- end\n -- end , -- this sorts files and directories descendantly\n default_component_configs = {\n container = {\n enable_character_fade = true\n },\n indent = {\n indent_size = 2,\n padding = 1, -- extra padding on left hand side\n -- indent guides\n with_markers = true,\n indent_marker = \"│\",\n last_indent_marker = \"└\",\n highlight = \"NeoTreeIndentMarker\",\n -- expander config, needed for nesting files\n with_expanders = nil, -- if nil and file nesting is enabled, will enable expanders\n expander_collapsed = \"\",\n expander_expanded = \"\",\n expander_highlight = \"NeoTreeExpander\",\n },\n icon = {\n folder_closed = \"\",\n folder_open = \"\",\n folder_empty = \"󰜌\",\n -- The next two settings are only a fallback, if you use nvim-web-devicons and configure default icons there\n -- then these will never be used.\n default = \"*\",\n highlight = \"NeoTreeFileIcon\"\n },\n modified = {\n symbol = \"[+]\",\n highlight = \"NeoTreeModified\",\n },\n name = {\n trailing_slash = false,\n use_git_status_colors = true,\n highlight = \"NeoTreeFileName\",\n },\n git_status = {\n symbols = {\n -- Change type\n added = \"\", -- or \"✚\", but this is redundant info if you use git_status_colors on the name\n modified = \"\", -- or \"\", but this is redundant info if you use git_status_colors on the name\n deleted = \"✖\",-- this can only be used in the git_status source\n renamed = \"󰁕\",-- this can only be used in the git_status source\n -- Status type\n untracked = \"\",\n ignored = \"\",\n unstaged = \"󰄱\",\n staged = \"\",\n conflict = \"\",\n }\n },\n -- If you don't want to use these columns, you can set `enabled = false` for each of them individually\n file_size = {\n enabled = true,\n required_width = 64, -- min width of window required to show this column\n },\n type = {\n enabled = true,\n required_width = 122, -- min width of window required to show this column\n },\n last_modified = {\n enabled = true,\n required_width = 88, -- min width of window required to show this column\n },\n created = {\n enabled = true,\n required_width = 110, -- min width of window required to show this column\n },\n symlink_target = {\n enabled = false,\n },\n },\n -- A list of functions, each representing a global custom command\n -- that will be available in all sources (if not overridden in `opts[source_name].commands`)\n -- see `:h neo-tree-custom-commands-global`\n commands = {},\n window = {\n position = \"left\",\n width = 40,\n mapping_options = {\n noremap = true,\n nowait = true,\n },\n mappings = {\n [\"\"] = { \n \"toggle_node\", \n nowait = false, -- disable `nowait` if you have existing combos starting with this char that you want to use \n },\n [\"<2-LeftMouse>\"] = \"open\",\n [\"\"] = \"open\",\n [\"\"] = \"cancel\", -- close preview or floating neo-tree window\n [\"P\"] = { \"toggle_preview\", config = { use_float = true, use_image_nvim = true } },\n -- Read `# Preview Mode` for more information\n [\"l\"] = \"focus_preview\",\n [\"S\"] = \"open_split\",\n [\"s\"] = \"open_vsplit\",\n -- [\"S\"] = \"split_with_window_picker\",\n -- [\"s\"] = \"vsplit_with_window_picker\",\n [\"t\"] = \"open_tabnew\",\n -- [\"\"] = \"open_drop\",\n -- [\"t\"] = \"open_tab_drop\",\n [\"w\"] = \"open_with_window_picker\",\n --[\"P\"] = \"toggle_preview\", -- enter preview mode, which shows the current node without focusing\n [\"C\"] = \"close_node\",\n -- ['C'] = 'close_all_subnodes',\n [\"z\"] = \"close_all_nodes\",\n --[\"Z\"] = \"expand_all_nodes\",\n [\"a\"] = { \n \"add\",\n -- this command supports BASH style brace expansion (\"x{a,b,c}\" -> xa,xb,xc). see `:h neo-tree-file-actions` for details\n -- some commands may take optional config options, see `:h neo-tree-mappings` for details\n config = {\n show_path = \"none\" -- \"none\", \"relative\", \"absolute\"\n }\n },\n [\"A\"] = \"add_directory\", -- also accepts the optional config.show_path option like \"add\". this also supports BASH style brace expansion.\n [\"d\"] = \"delete\",\n [\"r\"] = \"rename\",\n [\"y\"] = \"copy_to_clipboard\",\n [\"x\"] = \"cut_to_clipboard\",\n [\"p\"] = \"paste_from_clipboard\",\n [\"c\"] = \"copy\", -- takes text input for destination, also accepts the optional config.show_path option like \"add\":\n -- [\"c\"] = {\n -- \"copy\",\n -- config = {\n -- show_path = \"none\" -- \"none\", \"relative\", \"absolute\"\n -- }\n --}\n [\"m\"] = \"move\", -- takes text input for destination, also accepts the optional config.show_path option like \"add\".\n [\"q\"] = \"close_window\",\n [\"R\"] = \"refresh\",\n [\"?\"] = \"show_help\",\n [\"<\"] = \"prev_source\",\n [\">\"] = \"next_source\",\n [\"i\"] = \"show_file_details\",\n }\n },\n nesting_rules = {},\n filesystem = {\n filtered_items = {\n visible = false, -- when true, they will just be displayed differently than normal items\n hide_dotfiles = true,\n hide_gitignored = true,\n hide_hidden = true, -- only works on Windows for hidden files/directories\n hide_by_name = {\n --\"node_modules\"\n },\n hide_by_pattern = { -- uses glob style patterns\n --\"*.meta\",\n --\"*/src/*/tsconfig.json\",\n },\n always_show = { -- remains visible even if other settings would normally hide it\n --\".gitignored\",\n },\n never_show = { -- remains hidden even if visible is toggled to true, this overrides always_show\n --\".DS_Store\",\n --\"thumbs.db\"\n },\n never_show_by_pattern = { -- uses glob style patterns\n --\".null-ls_*\",\n },\n },\n follow_current_file = {\n enabled = false, -- This will find and focus the file in the active buffer every time\n -- -- the current file is changed while the tree is open.\n leave_dirs_open = false, -- `false` closes auto expanded dirs, such as with `:Neotree reveal`\n },\n group_empty_dirs = false, -- when true, empty folders will be grouped together\n hijack_netrw_behavior = \"open_default\", -- netrw disabled, opening a directory opens neo-tree\n -- in whatever position is specified in window.position\n -- \"open_current\", -- netrw disabled, opening a directory opens within the\n -- window like netrw would, regardless of window.position\n -- \"disabled\", -- netrw left alone, neo-tree does not handle opening dirs\n use_libuv_file_watcher = false, -- This will use the OS level file watchers to detect changes\n -- instead of relying on nvim autocmd events.\n window = {\n mappings = {\n [\"\"] = \"navigate_up\",\n [\".\"] = \"set_root\",\n [\"H\"] = \"toggle_hidden\",\n [\"/\"] = \"fuzzy_finder\",\n [\"D\"] = \"fuzzy_finder_directory\",\n [\"#\"] = \"fuzzy_sorter\", -- fuzzy sorting using the fzy algorithm\n -- [\"D\"] = \"fuzzy_sorter_directory\",\n [\"f\"] = \"filter_on_submit\",\n [\"\"] = \"clear_filter\",\n [\"[g\"] = \"prev_git_modified\",\n [\"]g\"] = \"next_git_modified\",\n [\"o\"] = { \"show_help\", nowait=false, config = { title = \"Order by\", prefix_key = \"o\" }},\n [\"oc\"] = { \"order_by_created\", nowait = false },\n [\"od\"] = { \"order_by_diagnostics\", nowait = false },\n [\"og\"] = { \"order_by_git_status\", nowait = false },\n [\"om\"] = { \"order_by_modified\", nowait = false },\n [\"on\"] = { \"order_by_name\", nowait = false },\n [\"os\"] = { \"order_by_size\", nowait = false },\n [\"ot\"] = { \"order_by_type\", nowait = false },\n },\n fuzzy_finder_mappings = { -- define keymaps for filter popup window in fuzzy_finder_mode\n [\"\"] = \"move_cursor_down\",\n [\"\"] = \"move_cursor_down\",\n [\"\"] = \"move_cursor_up\",\n [\"\"] = \"move_cursor_up\",\n },\n },\n\n commands = {} -- Add a custom command or override a global one using the same function name\n },\n buffers = {\n follow_current_file = {\n enabled = true, -- This will find and focus the file in the active buffer every time\n -- -- the current file is changed while the tree is open.\n leave_dirs_open = false, -- `false` closes auto expanded dirs, such as with `:Neotree reveal`\n },\n group_empty_dirs = true, -- when true, empty folders will be grouped together\n show_unloaded = true,\n window = {\n mappings = {\n [\"bd\"] = \"buffer_delete\",\n [\"\"] = \"navigate_up\",\n [\".\"] = \"set_root\",\n [\"o\"] = { \"show_help\", nowait=false, config = { title = \"Order by\", prefix_key = \"o\" }},\n [\"oc\"] = { \"order_by_created\", nowait = false },\n [\"od\"] = { \"order_by_diagnostics\", nowait = false },\n [\"om\"] = { \"order_by_modified\", nowait = false },\n [\"on\"] = { \"order_by_name\", nowait = false },\n [\"os\"] = { \"order_by_size\", nowait = false },\n [\"ot\"] = { \"order_by_type\", nowait = false },\n }\n },\n },\n git_status = {\n window = {\n position = \"float\",\n mappings = {\n [\"A\"] = \"git_add_all\",\n [\"gu\"] = \"git_unstage_file\",\n [\"ga\"] = \"git_add_file\",\n [\"gr\"] = \"git_revert_file\",\n [\"gc\"] = \"git_commit\",\n [\"gp\"] = \"git_push\",\n [\"gg\"] = \"git_commit_and_push\",\n [\"o\"] = { \"show_help\", nowait=false, config = { title = \"Order by\", prefix_key = \"o\" }},\n [\"oc\"] = { \"order_by_created\", nowait = false },\n [\"od\"] = { \"order_by_diagnostics\", nowait = false },\n [\"om\"] = { \"order_by_modified\", nowait = false },\n [\"on\"] = { \"order_by_name\", nowait = false },\n [\"os\"] = { \"order_by_size\", nowait = false },\n [\"ot\"] = { \"order_by_type\", nowait = false },\n }\n }\n }\n })\n\n vim.cmd([[nnoremap \\ :Neotree reveal]])\n end\n}\n```\n\n_The above configuration is not everything that can be changed, it's just the\nparts you might want to change first._\n\n\nSee `:h neo-tree` for full documentation. You can also preview that online at\n[doc/neo-tree.txt](doc/neo-tree.txt), although it's best viewed within vim.\n\n\nTo see all of the default config options with commentary, you can view it online\nat [lua/neo-tree/defaults.lua](lua/neo-tree/defaults.lua). You can also paste it\ninto a buffer after installing Neo-tree by running: \n\n```\n:lua require(\"neo-tree\").paste_default_config()\n```\n\n## The `:Neotree` Command\n\nThe single `:Neotree` command accepts a range of arguments that give you full\ncontrol over the details of what and where it will show. For example, the following \ncommand will open a file browser on the right hand side, \"revealing\" the currently\nactive file:\n\n```\n:Neotree filesystem reveal right\n```\n\nArguments can be specified as either a key=value pair or just as the value. The\nkey=value form is more verbose but may help with clarity. For example, the command\nabove can also be specified as:\n\n```\n:Neotree source=filesystem reveal=true position=right\n```\n\nAll arguments are optional and can be specified in any order. If you issue the command\nwithout any arguments, it will use default values for everything. For example:\n\n```\n:Neotree\n```\n\nwill open the filesystem source on the left hand side and focus it, if you are using \nthe default config.\n\n### Tab Completion\n\nNeotree supports tab completion for all arguments. Once a given argument has a value,\nit will stop suggesting those completions. It will also offer completions for paths.\nThe simplest way to disambiguate a path from another type of argument is to start\nthem with `/` or `./`.\n\n### Arguments\n\nHere is the full list of arguments you can use:\n\n#### `action`\nWhat to do. Can be one of:\n\n| Option | Description |\n|--------|-------------|\n| focus | Show and/or switch focus to the specified Neotree window. DEFAULT |\n| show | Show the window, but keep focus on your current window. |\n| close | Close the window(s) specified. Can be combined with \"position\" and/or \"source\" to specify which window(s) to close. |\n\n#### `source`\nWhat to show. Can be one of:\n\n| Option | Description |\n|--------|-------------|\n| filesystem | Show a file browser. DEFAULT |\n| buffers | Show a list of currently open buffers. |\n| git_status | Show the output of `git status` in a tree layout. |\n| last | Equivalent to the last source used |\n\n#### `position`\nWhere to show it, can be one of:\n\n| Option | Description |\n|---------|-------------|\n| left | Open as left hand sidebar. DEFAULT |\n| right | Open as right hand sidebar. |\n| top | Open as top window. |\n| bottom | Open as bottom window. |\n| float | Open as floating window. |\n| current | Open within the current window, like netrw or vinegar would. |\n\n#### `toggle`\nThis is a boolean flag. Adding this means that the window will be closed if it\nis already open.\n\n#### `dir`\nThe directory to set as the root/cwd of the specified window. If you include a\ndirectory as one of the arguments, it will be assumed to be this option, you\ndon't need the full dir=/path. You may use any value that can be passed to the\n'expand' function, such as `%:p:h:h` to specify two directories up from the\ncurrent file. For example:\n\n```\n:Neotree ./relative/path\n:Neotree /home/user/relative/path\n:Neotree dir=/home/user/relative/path\n:Neotree position=current dir=relative/path\n```\n\n#### `git_base`\nThe base that is used to calculate the git status for each dir/file.\nBy default it uses `HEAD`, so it shows all changes that are not yet committed.\nYou can for example work on a feature branch, and set it to `main`. It will\nshow all changes that happened on the feature branch and main since you \nbranched off.\n\nAny git ref, commit, tag, or sha will work.\n\n```\n:Neotree main\n:Neotree v1.0\n:Neotree git_base=8fe34be\n:Neotree git_base=HEAD\n```\n\n#### `reveal`\nThis is a boolean flag. Adding this will make Neotree automatically find and \nfocus the current file when it opens.\n\n#### `reveal_file`\nA path to a file to reveal. This supersedes the \"reveal\" flag so there is no\nneed to specify both. Use this if you want to reveal something other than the\ncurrent file. If you include a path to a file as one of the arguments, it will\nbe assumed to be this option. Like \"dir\", you can pass any value that can be\npassed to the 'expand' function. For example:\n\n```\n:Neotree reveal_file=/home/user/my/file.text\n:Neotree position=current dir=%:p:h:h reveal_file=%:p\n:Neotree current %:p:h:h %:p\n```\n\nOne neat trick you can do with this is to open a Neotree window which is\nfocused on the file under the cursor using the `` keyword:\n\n```\nnnoremap gd :Neotree float reveal_file= reveal_force_cwd\n```\n\n#### `reveal_force_cwd`\nThis is a boolean flag. Normally, if you use one of the reveal options and the\ngiven file is not within the current working directory, you will be asked if you\nwant to change the current working directory. If you include this flag, it will\nautomatically change the directory without prompting. This option implies\n\"reveal\", so you do not need to specify both.\n\n#### `selector`\nThis is a boolean flag. When you specifically set this to false (`selector=false`)\nneo-tree will disable the [source selector](#source-selector) for that neo-tree\ninstance. Otherwise, the source selector will depend on what you specified in\nthe configuration (`config.source_selector.{winbar,statusline}`).\n\nSee `:h neo-tree-commands` for details and a full listing of available arguments.\n\n### File Nesting\n\nSee `:h neo-tree-file-nesting` for more details about file nesting.\n\n\n### Netrw Hijack\n\n```\n:edit .\n:[v]split .\n```\n\nIf `\"filesystem.window.position\"` is set to `\"current\"`, or if you have specified\n`filesystem.hijack_netrw_behavior = \"open_current\"`, then any command\nthat would open a directory will open neo-tree in the specified window.\n\n\n## Sources\n\nNeo-tree is built on the idea of supporting various sources. Sources are\nbasically interface implementations whose job it is to provide a list of\nhierarchical items to be rendered, along with commands that are appropriate to\nthose items.\n\n### filesystem\nThe default source is `filesystem`, which displays your files and folders. This\nis the default source in commands when none is specified.\n\nThis source can be used to:\n- Browse the filesystem\n- Control the current working directory of nvim\n- Add/Copy/Delete/Move/Rename files and directories\n- Search the filesystem\n- Monitor git status and lsp diagnostics for the current working directory\n\n### buffers\n![Neo-tree buffers](https://github.com/nvim-neo-tree/resources/raw/main/images/Neo-tree-buffers.png)\n\nAnother available source is `buffers`, which displays your open buffers. This is\nthe same list you would see from `:ls`. To show with the `buffers` list, use:\n\n```\n:Neotree buffers\n```\n\n### git_status\nThis view take the results of the `git status` command and display them in a\ntree. It includes commands for adding, unstaging, reverting, and committing.\n\nThe screenshot below shows the result of `:Neotree float git_status` while the \nfilesystem is open in a sidebar:\n\n![Neo-tree git_status](https://github.com/nvim-neo-tree/resources/raw/main/images/Neo-tree-git_status.png)\n\nYou can specify a different git base here as well. But be aware that it is not\npossible to unstage / revert a file that is already committed.\n\n```\n:Neotree float git_status git_base=main\n```\n\n### document_symbols\n\n![Neo-tree document_symbols](https://github.com/nvim-neo-tree/resources/raw/main/images/neo-tree-document-symbols.png)\nThe document_symbols source lists the symbols in the current document obtained\nby the LSP request \"textDocument/documentSymbols\". It currently supports the\nfollowing features:\n- [x] UI:\n\t- [x] Display all symbols in the current file with symbol kinds\n\t- [x] Symbols nesting\n\t- [x] Configurable kinds' name and icon\n\t- [x] Auto-refresh symbol list\n - [x] Follow cursor\n- [ ] Commands\n\t- [x] Jump to symbols, open symbol in split,... (`open_split` and friends)\n\t- [x] Rename symbols (`rename`)\n\t- [x] Preview symbol (`preview` and friends)\n\t- [ ] Hover docs\n\t- [ ] Call hierarchy \n- [x] LSP\n - [x] LSP Support\n - [x] LSP server selection (ignore, allow_only, use first, use all, etc.)\n- [ ] CoC Support\n\nSee #879 for the tracking issue of these features.\n\nThis source is currently experimental, so in order to use it, you need to first \nadd `\"document_symbols\"` to `config.sources` and open it with the command\n```\n:Neotree document_symbols\n```\n\n### External Sources\n\nThere are more sources available as extensions that are managed outside of this repository. See the\n[wiki](https://github.com/nvim-neo-tree/neo-tree.nvim/wiki/External-Sources) for me information.\n\n### Source Selector\n\n![Neo-tree source selector](https://github.com/nvim-neo-tree/resources/raw/main/images/Neo-tree-source-selector.png)\n\nYou can enable a clickable source selector in either the winbar (requires neovim 0.8+) or the statusline.\nTo do so, set one of these options to `true`:\n\n```lua\n require(\"neo-tree\").setup({\n source_selector = {\n winbar = false,\n statusline = false\n }\n })\n```\n\nThere are many configuration options to change the style of these tabs. \nSee [lua/neo-tree/defaults.lua](lua/neo-tree/defaults.lua) for details.\n\n### Preview Mode\n\n`:h neo-tree-preview-mode`\n\nPreview mode will temporarily show whatever file the cursor is on without\nswitching focus from the Neo-tree window. By default, files will be previewed\nin a new floating window. This can also be configured to automatically choose\nan existing split by configuring the command like this:\n\n```lua\nrequire(\"neo-tree\").setup({\n window = {\n mappings = {\n [\"P\"] = { \"toggle_preview\", config = { use_float = false, use_image_nvim = true } },\n }\n }\n})\n```\n\nAnything that causes Neo-tree to lose focus will end preview mode. When\n`use_float = false`, the window that was taken over by preview mode will revert\nback to whatever was shown in that window before preview mode began.\n\nIf you want to work with the floating preview mode window in autocmds or other\ncustom code, the window will have the `neo-tree-preview` filetype.\n\nWhen preview mode is not using floats, the window will have the window local\nvariable `neo_tree_preview` set to `1` to indicate that it is being used as a\npreview window. You can refer to this in statusline and winbar configs to mark a\nwindow as being used as a preview.\n\n#### Image Support in Preview Mode\n\nIf you have [3rd/image.nvim](https://github.com/3rd/image.nvim) installed, preview\nmode supports image rendering by default using kitty graphics protocol or ueberzug\n([Video](https://user-images.githubusercontent.com/41065736/277180763-b7152637-f310-43a5-b8c3-4bcba135629d.mp4)).\nHowever, if you do not want this feature, you can disable it by changing the option\n`use_image_nvim = false` in the mappings config mentioned above.\n\n## Configuration and Customization\n\nThis is designed to be flexible. The way that is achieved is by making\neverything a function, or a string that identifies a built-in function. All of the\nbuilt-in functions can be replaced with your own implementation, or you can \nadd new ones.\n\nEach node in the tree is created from the renderer specified for the given node\ntype, and each renderer is a list of component configs to be rendered in order. \nEach component is a function, either built-in or specified in your config. Those\nfunctions simply return the text and highlight group for the component.\n\nAdditionally, there is an events system that you can hook into. If you want to\nshow some new data point related to your files, gather it in the\n`before_render` event, create a component to display it, and reference that\ncomponent in the renderer for the `file` and/or `directory` type.\n\nDetails on how to configure everything is in the help file at `:h\nneo-tree-configuration` or online at\n[neo-tree.txt](https://github.com/nvim-neo-tree/neo-tree.nvim/blob/main/doc/neo-tree.txt)\n\nRecipes for customizations can be found on the [wiki](https://github.com/nvim-neo-tree/neo-tree.nvim/wiki/Recipes). Recipes include\nthings like adding a component to show the\n[Harpoon](https://github.com/ThePrimeagen/harpoon) index for files, or\nresponding to the `\"file_opened\"` event to auto clear the search when you open a\nfile.\n\n\n## Why?\n\nThere are many tree plugins for (neo)vim, so why make another one? Well, I\nwanted something that was:\n\n1. Easy to maintain and enhance.\n2. Stable.\n3. Easy to customize.\n\n### Easy to maintain and enhance\n\nThis plugin is designed to grow and be flexible. This is accomplished by making\nthe code as decoupled and functional as possible. Hopefully new contributors\nwill find it easy to work with.\n\nOne big difference between this plugin and the ones that came before it, which\nis also what finally pushed me over the edge into making a new plugin, is that\nwe now have libraries to build upon that did not exist when other tree plugins\nwere created. Most notably, [nui.nvim](https://github.com/MunifTanjim/nui.nvim)\nand [plenary.nvm](https://github.com/nvim-lua/plenary.nvim). Building upon\nshared libraries will go a long way in making neo-tree easy to maintain.\n\n### Stable\n\nThis project will have releases and release tags that follow a simplified\nSemantic Versioning scheme. The quickstart instructions will always refer to\nthe latest stable major version. Following the **main** branch is for\ncontributors and those that always want bleeding edge. There will be branches\nfor **v1.x**, **v2.x**, etc which will receive updates after a short testing\nperiod in **main**. You should be safe to follow those branches and be sure\nyour tree won't break in an update. There will also be tags for each release\npushed to those branches named **v1.1**, **v1.2**, etc. If stability is\ncritical to you, or a bug accidentally make it into **v1.x**, you can use those\ntags instead. It's possible we may backport bug fixes to those tags, but no\ngarauntees on that.\n\nThere will never be a breaking change within a major version (1.x, 2.x, etc.) If\na breaking change is needed, there will be depracation warnings in the prior\nmajor version, and the breaking change will happen in the next major version.\n\n### Easy to Customize\n\nNeo-tree follows in the spirit of plugins like\n[lualine.nvim](https://github.com/nvim-lualine/lualine.nvim) and\n[nvim-cokeline](https://github.com/noib3/nvim-cokeline). Everything will be\nconfigurable and take either strings, tables, or functions. You can take sane\ndefaults or build your tree items from scratch. There should be the ability to\nadd any features you can think of through existing hooks in the setup function.\n\n## What is a Breaking Change?\n\nAs of v1.30, a breaking change is defined as anything that _changes_ existing:\n\n- vim commands (`:Neotree`)\n- configuration options that are passed into the `setup()` function\n- `NeoTree*` highlight groups\n- lua functions exported in the following modules that are not prefixed with `_`:\n * `neo-tree`\n * `neo-tree.events`\n * `neo-tree.sources.manager`\n * `neo-tree.sources.*` (init.lua files)\n * `neo-tree.sources.*.commands`\n * `neo-tree.ui.renderer`\n * `neo-tree.utils`\n\nIf there are other functions you would like to use that are not yet considered\npart of the public API, please open an issue so we can discuss it.\n\n## Contributions\n\nContributions are encouraged. Please see [CONTRIBUTING](CONTRIBUTING.md) for more details.\n\n## Acknowledgements\n\n### Maintainers\n\nFirst and foremost, this project is a community endeavor and would not survive without the constant stream of features\nand bug fixes that comes from that community. There have been many valued contributors, but a few have stepped up to\nbecome maintainers that generously donate their time to guide the project, help out others, and manage the issues. The\ncurrent list of maintainers are:\n\n(in alphabetical order)\n\n- @cseickel\n- @miversen33\n- @nhat-vo\n- @pysan3\n\n### Other Projects\n\nThis project relies upon these two excellent libraries:\n- [nui.nvim](https://github.com/MunifTanjim/nui.nvim) for all UI components, including the tree!\n- [plenary.nvim](https://github.com/nvim-lua/plenary.nvim) for backend utilities, such as scanning the filesystem.\n\nThe design is heavily inspired by these excellent plugins:\n- [lualine.nvim](https://github.com/nvim-lualine/lualine.nvim)\n- [nvim-cokeline](https://github.com/noib3/nvim-cokeline)\n\nEverything I know about writing a tree control in lua, I learned from:\n- [nvim-tree.lua](https://github.com/nvim-tree/nvim-tree.lua)\n","dotfyleShieldAddedAt":null,"stars":2246,"lastSyncedAt":"2023-11-29T02:19:57.183Z","addedLastWeek":3}}}]}}]