feat(icons): use virtual text if possible (has('nvim') or has('textprop'))

Closes justinmk#145, justinmk#253

Author: brianhuster

autoload/dirvish.vim

@@ -426,7 +426,19 @@ func! s:apply_icons() abort
   if 0 == len(s:cb_map)
     return
   endif
-  highlight clear Conceal
+  if has('nvim')
+    if !exists('s:ns_id')
+      let s:ns_id = nvim_create_namespace('dirvish.icons')
+    endif
+  elseif v:version >= 901 && has('textprop')
+    if !exists('s:prop_type')
+      let s:prop_type = 'dirvish.icons'
+      call prop_type_add(s:prop_type, {})
+    endif
+  else
+    highlight clear Conceal
+  endif
+
   let i = 0
   for f in getline(1, '$')
     let i += 1
@@ -438,10 +450,16 @@ func! s:apply_icons() abort
       endif
     endfor
     if icon != ''
-      let isdir = (f[-1:] == s:sep)
-      let f = substitute(s:f(f), escape(s:sep,'\').'$', '', 'g')  " Full path, trim slash.
-      let tail_esc = escape(fnamemodify(f,':t').(isdir?(s:sep):''), '[,*.^$~\')
-      exe 'syntax match DirvishColumnHead =\%'.i.'l^.\{-}\ze'.tail_esc.'$= conceal cchar='.icon
+      if has('nvim-0.8')
+        call nvim_buf_set_extmark(0, s:ns_id, i-1, 0, #{virt_text: [[icon, 'DirvishColumnHead']], virt_text_pos: 'inline'})
+      elseif v:version >= 901 && has('textprop')
+        call prop_add(i, 1, #{type: s:prop_type, text: icon})
+      else
+        let isdir = (f[-1:] == s:sep)
+        let f = substitute(s:f(f), escape(s:sep,'\').'$', '', 'g')  " Full path, trim slash.
+        let tail_esc = escape(fnamemodify(f,':t').(isdir?(s:sep):''), '[,*.^$~\')
+        exe 'syntax match DirvishColumnHead =\%'.i.'l^.\{-}\ze'.tail_esc.'$= conceal cchar='.icon
+      endif
     endif
   endfor
 endf

doc/dirvish.txt

@@ -114,10 +114,12 @@ dirvish#add_icon_fn(fn)
     a given path, wins. Best practice: if you don't have anything meaningful
     to show for a given path, return empty string (or whitespace).
 
-    {fn} is any |Funcref| that takes a path (string) and returns a single
-    character (the "icon"). Example: >
+    {fn} is any |Funcref| that takes a path (string) and returns a string
+    (the "icon"). Example: >vim
         call dirvish#add_icon_fn({p -> p[-1:]=='/'?'📂':'📄'})
 <
+    Note: multi-character icons are only supported on Nvim 0.8+ or Vim 9.1+
+    with |+textprop|.
 
                                                     *dirvish#remove_icon_fn()*
 dirvish#remove_icon_fn(fn_id)