shell: nushell integration scripts

.bundle/config

@@ -0,0 +1,2 @@
+---
+BUNDLE_PATH: "vendor/bundle"

README.md

@@ -40,7 +40,7 @@ Highlights
 - **Portable** -- Distributed as a single binary for easy installation
 - **Fast** -- Optimized to process millions of items instantly
 - **Versatile** -- Fully customizable through an event-action binding mechanism
-- **All-inclusive** -- Comes with integrations for Bash, Zsh, Fish, Vim, and Neovim
+- **All-inclusive** -- Comes with integrations for Bash, Zsh, Fish, Nushell, Vim, and Neovim
 
 Table of Contents
 -----------------
@@ -210,9 +210,17 @@ Add the following line to your shell configuration file.
   # Set up fzf key bindings
   fzf --fish | source
   ```
+* Nushell — Nushell does not support piping into `source`, so the install
+  script generates a file in the autoload directory. If you didn't use the
+  install script, you can manually set it up:
+  ```nu
+  # Generate the integration script
+  # (run this in your regular shell, not in Nushell)
+  fzf --nushell > ($nu.default-config-dir | path join "autoload" "fzf.nu")
+  ```
 
 > [!NOTE]
-> `--bash`, `--zsh`, and `--fish` options are only available in fzf 0.48.0 or
+> `--bash`, `--zsh`, `--fish`, and `--nushell` options are only available in fzf 0.48.0 or
 > later. If you have an older version of fzf, or want finer control, you can
 > source individual script files in the [/shell](/shell) directory. The
 > location of the files may vary depending on the package manager you use.
@@ -506,7 +514,7 @@ Key bindings for command-line
 -----------------------------
 
 By [setting up shell integration](#setting-up-shell-integration), you can use
-the following key bindings in bash, zsh, and fish.
+the following key bindings in bash, zsh, fish, and Nushell.
 
 - `CTRL-T` - Paste the selected files and directories onto the command-line
     - The list is generated using `--walker file,dir,follow,hidden` option
@@ -574,7 +582,7 @@ More tips can be found on [the wiki page](https://github.com/junegunn/fzf/wiki/C
 Fuzzy completion
 ----------------
 
-Shell integration also provides fuzzy completion for bash, zsh, and fish.
+Shell integration also provides fuzzy completion for bash, zsh, fish, and Nushell.
 
 ### Files and directories
 
@@ -635,6 +643,23 @@ unalias **<TAB>
 set <SHIFT-TAB>
 ```
 
+### Nushell notes
+
+Fuzzy completion in Nushell works via the
+[external completer](https://www.nushell.sh/cookbook/external_completers.html)
+mechanism. There are some differences compared to bash and zsh:
+
+- On Nushell >= 0.103.0, the external completer is no longer called for
+  built-in commands (e.g. `cd`, `ls`). Fuzzy completion with `**<TAB>` only
+  works for external commands.
+- Custom completion extensibility (e.g. `_fzf_complete_COMMAND` in bash/zsh)
+  is not available. Custom completions are defined via a `match` statement
+  in `completion.nu`.
+- The following environment variables are supported:
+  `FZF_COMPLETION_TRIGGER`, `FZF_COMPLETION_OPTS`,
+  `FZF_COMPLETION_PATH_OPTS`, `FZF_COMPLETION_DIR_OPTS`,
+  `FZF_COMPLETION_DIR_COMMANDS`.
+
 ### Customizing fuzzy completion for bash and zsh
 
 #### Customizing fzf options for completion

debug_nu_2.rb

@@ -0,0 +1,28 @@
+require_relative 'test/lib/common'
+tmux = Tmux.new(:nushell)
+sleep 1
+# Simulate exactly what prepare() does, step by step
+puts "=== Step 1: send ' ', C-u, Enter ==="
+tmux.send_keys ' ', 'C-u', :Enter
+sleep 1
+lines = tmux.capture
+lines.each_with_index { |l, i| puts "#{i}: [#{l}]" }
+puts "=== Step 2: send message, Left, Right ==="
+tmux.send_keys 'Prepare[0]', :Left, :Right
+sleep 1
+lines = tmux.capture
+lines.each_with_index { |l, i| puts "#{i}: [#{l}]" }
+puts "lines[-1] = [#{lines[-1]}]"
+puts "match? #{lines[-1] == 'Prepare[0]'}"
+puts "=== Step 3: C-u, C-l ==="
+tmux.send_keys 'C-u', 'C-l'
+sleep 1
+lines = tmux.capture
+lines.each_with_index { |l, i| puts "#{i}: [#{l}]" }
+puts "=== Step 4: second prepare cycle ==="
+tmux.send_keys ' ', 'C-u', :Enter, 'Prepare[1]', :Left, :Right
+sleep 1
+lines = tmux.capture
+lines.each_with_index { |l, i| puts "#{i}: [#{l}]" }
+puts "lines[-1] = [#{lines[-1]}]"
+tmux.kill

install

@@ -6,10 +6,11 @@ version=0.71.0
 auto_completion=
 key_bindings=
 update_config=2
-shells="bash zsh fish"
+shells="bash zsh fish nushell"
 prefix='~/.fzf'
 prefix_expand=~/.fzf
 fish_dir=${XDG_CONFIG_HOME:-$HOME/.config}/fish
+nushell_autoload_dir=${XDG_CONFIG_HOME:-$HOME/.config}/nushell/autoload
 
 help() {
   cat << EOF
@@ -27,6 +28,7 @@ usage: $0 [OPTIONS]
     --no-bash            Do not set up bash configuration
     --no-zsh             Do not set up zsh configuration
     --no-fish            Do not set up fish configuration
+    --no-nushell         Do not set up nushell configuration
 EOF
 }
 
@@ -56,6 +58,7 @@ for opt in "$@"; do
     --no-bash) shells=${shells/bash/} ;;
     --no-zsh) shells=${shells/zsh/} ;;
     --no-fish) shells=${shells/fish/} ;;
+    --no-nushell) shells=${shells/nushell/} ;;
     *)
       echo "unknown option: $opt"
       help
@@ -224,7 +227,9 @@ fi
 [[ $* =~ "--bin" ]] && exit 0
 
 for s in $shells; do
-  if ! command -v "$s" > /dev/null; then
+  bin=$s
+  [[ "$s" = nushell ]] && bin=nu
+  if ! command -v "$bin" > /dev/null; then
     shells=${shells/$s/}
   fi
 done
@@ -251,7 +256,7 @@ for shell in $shells; do
   fzf_completion="source \"$fzf_base/shell/completion.${shell}\""
   fzf_key_bindings="source \"$fzf_base/shell/key-bindings.${shell}\""
   [[ $shell == fish ]] && continue
-  src=${prefix_expand}.${shell}
+  [[ $shell == nushell ]] && continue
   echo -n "Generate $src ... "
 
   if [ $auto_completion -eq 0 ]; then
@@ -368,6 +373,7 @@ fi
 echo
 for shell in $shells; do
   [[ $shell == fish ]] && continue
+  [[ $shell == nushell ]] && continue
   [ $shell = zsh ] && dest=${ZDOTDIR:-~}/.zshrc || dest=~/.bashrc
   append_line $update_config "[ -f ${prefix}.${shell} ] && source ${prefix}.${shell}" "$dest" "${prefix}.${shell}"
 done
@@ -436,6 +442,15 @@ if [[ $shells =~ fish ]]; then
   fi
 fi
 
+if [[ "$shells" =~ nushell ]]; then
+  echo "Setting up Nushell integration ..."
+  mkdir -p "$nushell_autoload_dir"
+  echo -n "  Generate fzf.nu ... "
+  "$fzf_base"/bin/fzf --nushell > "$nushell_autoload_dir/fzf.nu"
+  echo "OK"
+  echo
+fi
+
 if [ $update_config -eq 1 ]; then
   echo 'Finished. Restart your shell or reload config file.'
   if [[ $shells =~ bash ]]; then
@@ -445,6 +460,7 @@ if [ $update_config -eq 1 ]; then
   fi
   [[ $shells =~ zsh ]] && echo "   source ${ZDOTDIR:-~}/.zshrc   # zsh"
   [[ $shells =~ fish && $lno_func -ne 0 ]] && echo '   fish_user_key_bindings  # fish'
+  [[ $shells =~ nushell ]] && echo '   # nushell: files are loaded automatically from autoload directory'
   echo
   echo 'Use uninstall script to remove fzf.'
   echo

main.go

@@ -29,6 +29,12 @@ var zshCompletion []byte
 //go:embed shell/key-bindings.fish
 var fishKeyBindings []byte
 
+//go:embed shell/key-bindings.nu
+var nushellKeyBindings []byte
+
+//go:embed shell/completion.nu
+var nushellCompletion []byte
+
 //go:embed shell/completion.fish
 var fishCompletion []byte
 
@@ -71,6 +77,11 @@ func main() {
 		printScript("completion.fish", fishCompletion)
 		return
 	}
+	if options.Nushell {
+		printScript("key-bindings.nu", nushellKeyBindings)
+		printScript("completion.nu", nushellCompletion)
+		return
+	}
 	if options.Help {
 		fmt.Print(fzf.Usage)
 		return