safe-paste: refresh plugin (update for zsh 5.1 and vi keymaps) (#7887)

plugins/safe-paste/safe-paste.plugin.zsh

@@ -1,54 +1,100 @@
+# A good summary of the zsh 5.1 Bracketed Paste Mode changes is at:
+# https://archive.zhimingwang.org/blog/2015-09-21-zsh-51-and-bracketed-paste.html
+
+# zsh 5.1 (September 2015) introduced built-in support for Bracketed Paste Mode
+# https://github.com/zsh-users/zsh/blob/68405f31a043bdd5bf338eb06688ed3e1f740937/README#L38-L45
+#
+# zsh 5.1 breaks url-quote-magic and other widgets replacing self-insert
+# zsh-users' bracketed-paste-magic resolves these issues:
+# https://github.com/zsh-users/zsh/blob/f702e17b14d75aa21bff014168fa9048124db286/Functions/Zle/bracketed-paste-magic#L9-L12
+
+# Load bracketed-paste-magic if zsh version is >= 5.1
+if [[ ${ZSH_VERSION:0:3} -ge 5.1 ]]; then
+  set zle_bracketed_paste  # Explicitly restore this zsh default
+  autoload -Uz bracketed-paste-magic
+  zle -N bracketed-paste bracketed-paste-magic
+  return  ### The rest of this file is NOT executed on zsh version >= 5.1 ###
+fi
+
+######################################################################
+#    The rest of this file is ONLY executed if zsh version < 5.1
+######################################################################
+
 # Code from Mikael Magnusson: https://www.zsh.org/mla/users/2011/msg00367.html
 #
-# Requires xterm, urxvt, iTerm2 or any other terminal that supports bracketed
+# Requires xterm, urxvt, iTerm2 or any other terminal that supports
-# paste mode as documented: https://www.xfree86.org/current/ctlseqs.html
+# Bracketed Paste Mode as documented:
+# https://www.xfree86.org/current/ctlseqs.html#Bracketed%20Paste%20Mode
+#
+# For tmux, use:   bind ] paste-buffer -p
+#
+# Additional technical details: https://cirw.in/blog/bracketed-paste
 
-# create a new keymap to use while pasting
+# Create a new keymap to use while pasting
-bindkey -N paste
+bindkey -N bracketed-paste
-# make everything in this keymap call our custom widget
+# Make everything in this new keymap enqueue characters for pasting
-bindkey -R -M paste "^@"-"\M-^?" paste-insert
+bindkey -RM bracketed-paste '\x00-\xFF' bracketed-paste-enqueue
-# these are the codes sent around the pasted text in bracketed
+# These are the codes sent around the pasted text in bracketed paste mode
-# paste mode.
+bindkey -M main            '^[[200~' _bracketed_paste_begin
-# do the first one with both -M viins and -M vicmd in vi mode
+bindkey -M bracketed-paste '^[[201~' _bracketed_paste_end
-bindkey '^[[200~' _start_paste
+# Insert newlines rather than carriage returns when pasting newlines
-bindkey -M paste '^[[201~' _end_paste
+bindkey -M bracketed-paste -s '^M' '^J'
-# insert newlines rather than carriage returns when pasting newlines
-bindkey -M paste -s '^M' '^J'
 
-zle -N _start_paste
+zle -N _bracketed_paste_begin
-zle -N _end_paste
+zle -N _bracketed_paste_end
-zle -N zle-line-init _zle_line_init
+zle -N bracketed-paste-enqueue _bracketed_paste_enqueue
-zle -N zle-line-finish _zle_line_finish
-zle -N paste-insert _paste_insert
 
-# switch the active keymap to paste mode
+# Attempt to not clobber zle_line_{init,finish}
-function _start_paste() {
+# Use https://github.com/willghatch/zsh-hooks if available
-  bindkey -A paste main
+if typeset -f hooks-add-hook > /dev/null; then
+  hooks-add-hook zle_line_init_hook   _bracketed_paste_zle_init
+  hooks-add-hook zle_line_finish_hook _bracketed_paste_zle_finish
+else
+  zle -N zle-line-init   _bracketed_paste_zle_init
+  zle -N zle-line-finish _bracketed_paste_zle_finish
+fi
+
+# Switch the active keymap to paste mode
+_bracketed_paste_begin() {
+  # Save the bindkey command to restore the active ("main") keymap
+  # Tokenise the restorative bindkey command into an array
+  _bracketed_paste_restore_keymap=( ${(z)"$(bindkey -lL main)"} )
+  bindkey -A bracketed-paste main
 }
 
-# go back to our normal keymap, and insert all the pasted text in the
+# Go back to our normal keymap, and insert all the pasted text in the
-# command line. this has the nice effect of making the whole paste be
+# command line. This has the nice effect of making the whole paste be
 # a single undo/redo event.
-function _end_paste() {
+_bracketed_paste_end() {
-#use bindkey -v here with vi mode probably. maybe you want to track
+  # Only execute the restore command if it starts with 'bindkey'
-#if you were in ins or cmd mode and restore the right one.
+  # Allow for option KSH_ARRAYS being set (indexing starts at 0)
-  bindkey -e
+  if [ ${_bracketed_paste_restore_keymap[@]:0:1} = 'bindkey' ]; then
-  LBUFFER+=$_paste_content
+    $_bracketed_paste_restore_keymap
-  unset _paste_content
+  fi
+  LBUFFER+=$_bracketed_paste_content
+  unset _bracketed_paste_content _bracketed_paste_restore_keymap
 }
 
-function _paste_insert() {
+# Append a pasted character to the content which is later inserted as a whole
-  _paste_content+=$KEYS
+_bracketed_paste_enqueue() {
+  _bracketed_paste_content+=$KEYS
 }
 
-function _zle_line_init() {
+# Run at zle-line-init
-  # Tell terminal to send escape codes around pastes.
+_bracketed_paste_zle_init() {
-  [[ $TERM == rxvt-unicode || $TERM == xterm || $TERM = xterm-256color || $TERM = screen || $TERM = screen-256color ]] && printf '\e[?2004h'
+  _bracketed_paste_content=''
+  # Tell terminal to send escape codes around pastes
+  if [ $TERM =~ '^(rxvt-unicode|xterm(-256color)?|screen(-256color)?)$' ]; then
+    printf '\e[?2004h'
+  fi
 }
 
-function _zle_line_finish() {
+# Run at zle-line-finish
-  # Tell it to stop when we leave zle, so pasting in other programs
+_bracketed_paste_zle_finish() {
-  # doesn't get the ^[[200~ codes around the pasted text.
+  # Turn off bracketed paste when we leave ZLE, so pasting in other programs
-  [[ $TERM == rxvt-unicode || $TERM == xterm || $TERM = xterm-256color || $TERM = screen || $TERM = screen-256color ]] && printf '\e[?2004l'
+  # doesn't get the ^[[200~ codes around the pasted text
+  if [ $TERM =~ '^(rxvt-unicode|xterm(-256color)?|screen(-256color)?)$' ]; then
+    printf '\e[?2004l'
+  fi
 }