lambdalisue / vim-fall

🍂 Another fuzzy finder designed for Vim and Neovim and implemented in Denops

🍂 fall

Fall (vim-fall) is an abbreviation for "Filter All," another fuzzy finder designed for Vim and Neovim and implemented in Denops.

Alpha version. Please note that any changes, including those that may be backward incompatible, will be implemented without prior announcements.

Requirements

Users must install Deno.

Installation

To install Denops and this plugin using your preferred plugin manager, such as vim-plug, add the following lines to your Vim configuration:

Plug 'vim-denops/denops.vim'
Plug 'lambdalisue/vim-fall'

Usage

Use :Fall command to open the fuzzy finder. The command accepts the following arguments:

Fall {source} {source_args}...

For example, if you'd like to use file source, you can use the following

Fall file

Or line source with README.md as an argument

Fall line README.md

Similar Projects

• ddu.vim
  A highly customizable and extensible fuzzy finder for Vim/Neovim written in Denops.
• telescope.nvim
  The de facto standard fuzzy finder for Neovim.
• ctrlp.vim
  A classic and famous fuzzy finder for Vim.

License

The code in this repository follows the MIT license, as detailed in LICENSE. Contributors must agree that any modifications submitted to this repository also adhere to the license.

vim-fall's Issues

Add more builtin extensions

Source

• General
  • File
  • Line
  • List
  • Ripgrep
• Vim
  • buffer
  • window
  • tabpage
  • quickfix
  • loclist
  • oldfiles
  • grep
  • vimgrep
  • colorscheme
  • highlight
  • helptag
  • jumplist
  • register
  • mark
  • command
  • history (command, search)
  • mapping
• fall
  • extension
• extra (will be removed in beta release)
  • source from ddu source

Projector

• cwd filter
• exists filter
• substring filter
• lexical sort
• numerical sorter
• date sorter
• fzf matcher
• stat annotator
• bufinfo annotator
• to relative path

Renderer

• Nerdfont (These will be removed from builtin extensions in beta release)
  • nerdfont
    • https://github.com/lambdalisue/vim-fall-renderer-nerdfont
  • devicon
    • https://github.com/lambdalisue/vim-fall-renderer-devicons
  • nvim-web-devicon
    • https://github.com/lambdalisue/vim-fall-renderer-nvim-web-devicons
• smart path
• smart grep
• extension
• helptag
• File info (file size, permission, etc.)
• Buffer info (modified, buffer listed, etc.)

Previewer

• buffer
• file
• attribute
• helptag
• extension
• shell command

Action

• Vim
  • debug
  • open
  • quickfix
  • location list
  • cd/lcd/tcd (cmd:cd, cmd:lcd, cmd:tcd)
  • cmd
  • help (cmd:helptag)
  • function call
  • yank
  • write buffers (modified buffer) (cmd:write)
  • unload/delete/wipe buffers (cmd:bunload, cmd:bdelete, cmd:bwipeout)
• Others
  • system open

Add a way to install user custom extensions

Internally it's possible but I haven't expose because I'm planning to prepare community repository or catalog repository or whatever to register user custom extensions.

Screenshots

Add a way to customize picker configuration

Internally, it's possible but I haven't expose the interface

Syntax highlight in Preview component is not valid

It seems the following code does not apply proper (full) syntax highlight.

vim-fall/autoload/fall/internal/preview.vim

Lines 1 to 10 in 8a7f193

	function! fall#internal#preview#highlight() abort
	let l:eventignore = &eventignore
	try
	let &eventignore = join(split(&eventignore, ',') + ['FileType'], ',')
	silent! filetype detect
	silent! execute printf('runtime syntax/%s.vim', fnameescape(&filetype))
	finally
	let &eventignore = l:eventignore
	endtry
	endfunction

We need to avoid side-effects but we want full syntax highlight. If anyone know how to solve this issue, let me know.

The following screenshots shows the issue (background one is full syntax highlight and right side (preview component) is not fully syntax highlighted).

Vim

Neovim

Preview may breaks picker layout by user-defined autocmd

For example, assume that user have the following config

autocmd MyAutoCmd FileType help wincmd L

Then previewing help file break floating window on Neovim (it doesn't in Vim)

CleanShot.2024-03-08.at.01.14.59.mp4

Fall failed to start when background color is transparent

With guifg=NONE like https://github.com/lambdalisue/vim-seethrough does. Happens on Vim/Neovim.

Resize component window when Vim/Neovim itself is resized

Currently, the size of component windows are settled on picker/input startup, mean that when user resize Vim/Neovim, the screen disappear (Esc to cancel picker/input fix the screen)

Register `jsr:@lambdalisue/vim-fall` for third-party plugins

Once Denops v7 become ready...

Add builtin transformer/processor to perform fuzzy match

I don't use fuzzy match at all so the priority is not high but as long as fall.vim say it is a fuzzy finder, fuzzy match processor is required :-p

Maybe someone?

Pattern uses more memory than 'maxmempattern' on Neovim

When file source is used on my home directory.

Can't run with lazy

I tried to install the plugin but I got this error:

[denops] Failed to load plugin 'fall': TypeError: Could not find constraint in the list of versions: @std/assert@^0.226.0
[denops]   Specifier: jsr:/@std/assert@^0.226.0/assert
[denops]     at https://jsr.io/@std/cli/0.224.5/parse_args.ts:19:24

this is how I installed it:

return {
	"lambdalisue/vim-fall",
	lazy = false,
	dependencies = {
		"vim-denops/denops.vim",
	},
}

My nvim version is:

NVIM v0.11.0-dev-155+g9eb042600
Build type: Release
LuaJIT 2.1.1716656478
Run "nvim -V1 -v" for more info