.vimrc

"                   .
"   ##############......##############
"   ##############......##############
"     ##########..........##########
"     ##########........##########
"     ##########.......##########
"     ##########.....##########..
"     ##########....##########.....
"   ..##########..##########.........
" ....##########.#########.............
"   ..################JJJ............
"     ################.............
"     ##############.JJJ.JJJJJJJJJJ
"     ############...JJ...JJ..JJ  JJ
"     ##########....JJ...JJ..JJ  JJ
"     ########......JJJ..JJJ JJJ JJJ
"     ######    .........
"                 .....
"                   .
" -------------------------------------------------------------------------
" File: .vimrc
" Source: https://github.com/devpunks
" Author: devPunks (github.com/devpunks)
" Description: Vim(rc) configuration file.
" Gist: https://gist.github.com/snuggs/612093
" -------------------------------------------------------------------------
"
" Screencasts - http://vimcasts.org
" Cheatsheets:
"   - https://vim.rtorr.com
"   - https://devhints.io/vimscript
" TERM - https://vimhelp.org/term.txt.html
" Event order - https://vi.stackexchange.com/q/4493
" Auto Commands - https://vimhelp.org/autocmd.txt.html
" Tutorial - http://learnvimscriptthehardway.stevelosh.com
" https://w0rp.com/blog/post/vim-script-for-the-javascripter
" VIM9 Script - https://vimhelp.org/vim9.txt.html#Vim9-script
" Idiomatic .vimrc - https://github.com/romainl/idiomatic-vimrc
" Styleguide - https://google.github.io/styleguide/vimscriptguide.xml
" Programming - https://got-ravings.blogspot.com/2008/09/vim-pr0n-prototype-based-objects.html
"
" TODO:
" CLICKING LINE NUMBERS
"  - https:/reddit.com/r/vim/comments/86pjx4/does_vim_currently_have_a_way_to_handle_clicks_on

" =========================================================================

" -------------------------------------------------------------------------
messages clear " Clear messages
" -------------------------------------------------------------------------
" Reset all autocommand groups
augroup VimDefaults  | autocmd! | augroup END
augroup FileDefaults | autocmd! | augroup END
augroup UserDefaults | autocmd! | augroup END
" -------------------------------------------------------------------------

set encoding=UTF-8
scriptencoding UTF-8
set fileencoding=UTF-8
set termencoding=UTF-8
set emoji encoding=UTF-8

" https://stackoverflow.com/q/5845557
" TODO: remove if &compatible | set nocompatible | endif

if !!! exists ( 'g:pluginname_setting' )
  unlet! skip_defaults_vim
  let g:skip_defaults_vim=0
  source $VIMRUNTIME/defaults.vim
endif

execute 'set <FocusLost>=\<Esc>[O'
execute 'set <FocusGained>=\<Esc>[I'
" xterm-focus-event tracking - https://github.com/vim/vim/issues/9296
let &t_fe = '\<Esc>[?1004h' " enable focus-event tracking
let &t_fd = '\<Esc>[?1004l' " disable focus-event tracking
" https://groups.google.com/g/vim_use/c/VyQSx90uaPE

" NOTES -------------------------------------------------------------------
"  - https://superuser.com/q/935574/get-rid-of-null-character-in-vim-variable
"  - https://til.hashrocket.com/posts/qll3kizlzj-check-that-an-executable-exists-on-the-path
"  - Test executables - https://renenyffenegger.ch/notes/development/vim/script/vimscript/functions/executable
echom 'VIM:' v:version
echom 'BASH:' system ( 'echo -n $BASH_VERSION' )
if exists( '$TMUX' ) | echom "TMUX: " .. system( 'echo -n $(tmux -V)' ) | endif
if executable ( 'termux-info' ) | echom 'TERMUX:' $TERMUX_VERSION | endif

" =========================================================================
" {{{ SETTINGS
" =========================================================================
set shellcmdflag=-c " Make shell interactive
" TODO: Make shell -i(nteractive)
"set shellcmdflag=-ic " Make shell interactive
let $GIT_TRACE = 0
let &shell = $SHELL .. ' --login' " Add login
let $prefix = exists ( '$PREFIX' ) ? $PREFIX : '/usr' " Check for TERMUX $PREFIX

" - https://gist.github.com/romainl/7e2b425a1706cd85f04a0bd8b3898805
" - https://stackoverflow.com/q/2288756/how-to-set-working-current-directory-in-vim
set path =./**
set path +=$HOME
set path +=$prefix/include

echom '(vi) PATH:' &path
" increment formats - https://vimtricks.com/p/vimtrick-increment-numbers
set nrformats+=alpha
set nrformats-=octal

set updatetime=150 " (milliseconds)
" https://vimhelp.org/options.txt.html#%27timeout%27
set timeout " on mappings
set ttimeout " on keycodes
set ttimeoutlen=-1  " mappings
set timeoutlen=1000 " keykodes (milliseconds)

" https://vim.fandom.com/wiki/Folding
set foldenable
set foldlevel=1
set foldcolumn=2
set foldclose=all
set foldlevelstart=0
set foldmethod=indent " [ manual|indent|expr|marker|syntax|diff ]

set showcmd " show current command characters
set modeline " https://vim.fandom.com/wiki/Modeline_magic
set cmdheight=2 " sets the :ex command prompt line height
set modelines=1 " Head & tail mode lines (:help modeline)
set showcmdloc=statusline " Add current command to status
set showmatch matchtime=20 " jump to matching brace (in 1/10ths of seconds)

set wrapscan " Search respects wrapping
set hlsearch " result highlight grouping
set incsearch " highlight search matches
" TODO: Problematic for conditionals "A"=="a" vs "A"==?"a"
set smartcase " Capitalization case-sensitive search (overrides ignorecase)
" https://vi.stackexchange.com/q/11236
" https://learnvimscriptthehardway.stevelosh.com/chapters/22.html
set ignorecase " Case in-sensitive search
set fileignorecase " for files & directories

" Bells -------------------------------------------------------------------
" Set termcap(ability) for visual bell
set errorbells " Unset audio bell on errors
"set belloff+=wildmode " Turn off insert completion bell
" Set the window bell to flash
set t_vb=
if has ( 'gui_running' )
  set visualbell t_vb=|250f " Nf - where N = milliseconds
elseif exists ( '$TMUX' )
  set novisualbell " passthrough to TMUX
else
  " <N> - where N = milliseconds
  set visualbell t_vb=[?5h$<250>[?5l
endif

" Chrome ------------------------------------------------------------------
" shell window title
" http://www.faqs.org/docs/Linux-mini/Xterm-Title.html#s3
" $ echo -e "\033]2;Your New Title\007"
" https://vim.fandom.com/wiki/Automatically_set_screen_title
" set title
" set t_ts=^[k
" set t_fs=^[\\
set title " Turn on title
set titlelen=75 " Text length of title
set titlestring="VIM SHELL TITLE %<%F%=%l/%L-%P" " Window Title String format

" tabs
set tabline=%!TabLine()
set showtabline=2 " :help setting-tabline

set tabpanel=0 " hide
set tabpanelopt=vert,columns:27,align:right
set tabpanel=%!TabPanel()
function! TabPanel() abort
return printf ( "📑%-2d📄 %%f", g:actual_curtabpage )
endfunction
<
" Menus -------------------------------------------------------------------
" :menu " :help menu
let do_no_lazyload_menus = 1
source $VIMRUNTIME/menu.vim

" - http://vim.wikia.com/wiki/Great_wildmode/wildmenu_and_console_mouse
" - https://stackoverflow.com/q/9511253/how-to-effectively-use-vim-wildmenu
set wildmenu
set infercase
set wildchar=<Tab>
set wildcharm=<C-z> " macros
set wildmode=list:full
set wildoptions=pum,tagfile

set wildignorecase
" set wildignore+=.DS_STORE,.git/,.bundle/,.cache/,.config/,.gem/,.local/,.npm/,.gnupg/,.ssh/,.vim/,bin/,downloads/,log/,logs/,node_modules/,storage/,tmp/,vendor/,images/

function s:ignore ( file = '.gitignore' ) abort
  let l:exceptions = []
  let l:exclusions = []

  const l:root = fnamemodify (
    \ finddir ( '.git/..', expand ('%:p:h' ) .. ';' .. $HOME )
    \ ?? $HOME , ':p' )
  const l:file = l:root .. a:file

  echom 'Git Root:' l:root

  if !!! filereadable ( l:file ) | return | endif

  echom 'Git Ignore:' l:file

  for line in readfile ( l:file )
    if strlen ( trim ( line ) ) == 0 || match ( line, '^[ \t]*#' ) >= 0
      continue
    endif

    if match ( line, '^[ \t]*!' ) >= 0
      call add ( l:exceptions, trim ( line ) )
    endif

    if match ( line, '^[ \t]*!' ) < 0
      call add ( l:exclusions, trim ( line ) )
    endif
  endfor

  echom "\nExceptions:\n" ..
    \ l:exceptions ->uniq()
    \ ->map( { _, path -> substitute ( path, '^!', '**/', '' ) } )
    \ ->map( { _, path -> substitute ( path, '^**\/\/', '', '' ) } )
    \ ->join( ',' )

  return l:exclusions ->uniq()
    \ ->map( { _, path -> '**/' .. path } )
    \ ->map( { _, path -> substitute ( path, '^**\/\/', '', '' ) } )
    \ ->join( ',' )
endfunction " ignore

set wildignore=
let &g:wildignore=s:ignore ()

" Completion / LSPs -------------------------------------------------------
" (Insert) Tab complete
inoremap <expr> <Tab>   pumvisible () ? '<C-n>' : '<C-o>:Tab<CR>'
inoremap <expr> <S-Tab> pumvisible () ? '<C-p>' : '<C-o>:echom "INSERT SHIFT + TAB"<CR>'
inoremap <expr> <M-Tab> pumvisible () ? ':echo "PUM"<CR> :':echom "INSERT ALT + TAB"<CR>'

" https://linuxhandbook.com/vim-auto-complete
" https://vim.fandom.com/wiki/Make_Vim_completion_popup_menu_work_just_like_in_an_IDE
" https://github.com/neoclide/coc.nvim/wiki/Using-coc-extensions#implemented-coc-extensions
set complete=.,t ".,w,b,u,i " -t - https://mail-archive.com/vim@vim.org/msg03963.html
set completepopup+=align:item,border:on
set completeopt+=menuone,noinsert,popup " noselect|noinsert for automatic completion

" -------------------------------------------------------------------------
" Complete () -
" -------------------------------------------------------------------------
set completefunc=s:complete
command! -bang -nargs=* Complete call s:complete ( <q-args>, v:none, v:none, <bang>0 )
function! s:complete ( token = '', command = '', cursor = 0, bang = 0 ) " abort
  echom 'complete ():' .. join ( a:000, ',' )

  let l:token =  trim ( a:token ?? expand ( '<cword>' ) ) ?? '.'

  echom 'Bang:' a:bang
  echom 'Base:'  a:command
  echom 'Cursor Position:' a:cursor
  echom 'Token: "' .. l:token .. '"'

  echom 'Shazaam Completion (' l:token '):'

  " Check if token is a number
  return l:token =~# '^\d\+$'
  \ ? l:token
  \ : { 'refresh': 'always', 'words': [
      \ { 'word': 'fooooo', 'abbr':'fo', 'menu': 'foo', 'info': 'brown fox',
        \ 'kind': 'C', 'icase': 0, 'equal': 0, 'dup':1, 'empty': 0, 'user_data': '' },
      \ { 'word': 'barrrrr', 'abbr':'ba', 'menu': 'bar', 'info': 'Lazy Dog',
        \ 'kind': 'v', 'icase': 0, 'equal': 0, 'dup':1, 'empty': 0, 'user_data': '' }
    \ ] }
endfunction " complete

" }}}

" =========================================================================
" {{{ Copy & 🍝Pasta
"   :h clipboard
" =========================================================================
set selection=exclusive " No EOL CR/LF
set pastetoggle=<Leader>p " Allow toggle of (paste) insert indentation
set nopaste " non paste mode - https://vimtricks.com/p/vimtricks-avoid-paste-formatting

echom has ( 'clipboard_working' ) ?
\ 'Copy & 🍝Pasta' : '❌ NO Copy & 🍝Pasta'

" Clipboard Registers -----------------------------------------------------
"   - https://stackoverflow.com/q/11489428
"   - https://github.com/termux/termux-packages/issues/2308
"   - https://vimtricks.com/p/vimtrick-the-clipboard-register
"   - https://reddit.com/r/termux/comments/c17rwf/how_to_paste_to_vim_from_external_clipboard
"   - OSC52 Escape to system clipboard - https://chromium.googlesource.com/apps/libapps/+/master/hterm/etc/osc52.vim

" vnoremap <C-c> "*y<cr>
" inoremap <C-v> “*p<cr>
if has ( 'unnamedplus' ) | set clipboard=unnamed,unnamedplus
else | set clipboard+=unnamed
endif

"  copy and paste
" vmap <C-c> "+yi
" vmap <C-x> "+c
" vmap <C-v> c<ESC>"+p
" imap <C-v> <ESC>"+pa

" Termux ------------------------------------------------------------------
" https://ibnishak.github.io/blog/post/copy-to-termux-clip
if executable ( 'termux-clipboard-set' )
  echom 'Termux Copy & 🍝Pasta'
  " vnoremap <C-x> :!termux-clipboard-set<CR>
  " vnoremap <C-c> :w !termux-clipboard-set<CR><CR>
  " inoremap <C-v> <ESC>:read !termux-clipboard-get<CR>i
else
  echom '❌ NO Termux Copy & 🍝Pasta'
endif

" }}}

" =========================================================================
" {{{ BUFFERS
" =========================================================================
" set nohidden possibly overridden by ZoomWin https://vimtricks.com/p/what-is-set-hidden
set hidden
set confirm "  on persistence
set autowrite " on lost focus
set nohidden " Unload buffer when abandoned
set bufhidden=unload " [hide|unload|delete]

set equalalways " on load
set winwidth=1 " initial width
set winheight=1 " initial height
set winminwidth=0 " minimum width
set winminheight=0 " minimum height
set history=1000 " Increase undo limit
set tabpagemax=50 " Maximum number of tab pages
set switchbuf=usetab,newtab " split|vsplit|useopen|uselast
set splitbelow nosplitright " Where to place new buffer location
command! Flush :update | %bd | e# " https://vimtricks.com/p/closing-hidden-buffers

" autocmd QuickFixCmdPre * echom 'Executing QuickFixCmdPre'
" autocmd QuickFixCmdPost * echom 'Executing QuickFixCmdPost'

" }}}

" =========================================================================
" {{{ VIEWS, SESSIONS, VIMINFO
"   - https://vimtricks.com/p/saving-session-state
"   - https://learnvim.irian.to/basics/views_sessions_viminfo
" =========================================================================
" disable sessions
set viewoptions-=options
set viewoptions+=localoptions
set viewdir=$HOME/.vim/view

set sessionoptions-=options
set sessionoptions+=resize,winpos

set viminfo="NONE" " disable .viminfo
set viminfofile="NONE" " disable .viminfo
set viminfo='100,<50,s10,h,%

set viminfofile=$HOME/.vim/.viminfo

" }}}

" =========================================================================
" {{{ BACKUPS
"   - https://groups.google.com/g/vim_use/c/K2Utwkh5f30?pli=1
"   - https://alvinalexander.com/linux-unix/vi-vim-swap-backup-tilde-temporary-files-directory-move
" =========================================================================
set backup " keep a backup file (nobackup for inverse)
" Undo location
" set nobackup
" set nowritebackup
" set noswapfile
" set noundofile

set undodir=$TMPDIR " undo location
set directory=$TMPDIR " swap location
set backupdir=$TMPDIR " backup location

" }}}

" =========================================================================
" {{{ CURSOR
" =========================================================================
set ttyfast " for redraws

set nolazyredraw " Fast non-macro updates
set ttyscroll=3 " number of characters for redraws

set cursorline " highlight current cursor line
set cursorcolumn " highlight current cursor column
set nostartofline " respect cursor column position
set cursorlineopt=both " [number,line,both,screenline]

" reset cursor escapes
" use  CSI for single quotes ('')
" use \e CSI for double quotes ("")
" https://stackoverflow.com/q/6488683
" https://vim.fandom.com/wiki/Change_cursor_shape_in_different_modes
let &t_SI = '' " START INSERT
let &t_SR = '' " START REPLACE
let &t_EI = '' " NORMAL (EXIT INSERT)

" CURSOR TYPE -------------------------------------------------------------
" 0 Default
" 1 Block (blinking)
" 2 Block (steady)
" 3 Underline (blinking)
" 4 Underline (steady)
" 5 Bar (blinking) (xterm)
" 6 Bar (steady) (xterm)
let &t_SI..="\e[5;0;0 q" " SI = START INSERT bar |
let &t_SR..="\e[3;0;0 q" " SR = START REPLACE underline _
let &t_EI..="\e[1;0;0 q" " EI = NORMAL (EXIT INSERT) block

" CURSOR COLOR ------------------------------------------------------------
let &t_SI..="\e]12;red\x7"   " INSERT = red cursor
let &t_SR..="\e]12;blue\x7"  " REPLACE = blue cursor
let &t_EI..="\e]12;green\x7" " NORMAL = green cursor
" reset cursor when vim exits
" autocmd VimLeave * silent !echo -ne "]12;cyan\x7"
autocmd VimDefaults VimLeave * silent !echo -ne '[0;0;0 q'

" GUI CURSOR --------------------------------------------------------------
if has ( 'gui_running' )
  set guioptions=egmrt " remove ugly toolbar :-)
  " https://vim.fandom.com/wiki/Configuring_the_cursor
  set guicursor=i:blinkwait90
  set guicursor+=i:ver100-iCursor
  set guicursor+=n-v-c:blinkwait10
  set guicursor+=n-v-c:block-Cursor
endif

" }}}

" =========================================================================
" {{{ MOUSE
"   - https://vimhelp.org/options.txt.html#%27ttymouse%27
" =========================================================================
set t_RV= " Disable automatic mouse detection
if has ( 'mouse' ) | set mouse=a | endif " Enable mouse use in a(ll) modes

" https://vld.bg/articles/ttymouse-sgr
" https://stackoverflow.com/a/19253251
" https://stackoverflow.com/q/7000960/in-vim-why-doesnt-my-mouse-work-past-the-220th-column
if has ( 'mouse_sgr' ) | set ttymouse=sgr " Set sgr mouse
else | set ttymouse=xterm2 " degrade to xterm2 mouse
endif

" }}}

" =========================================================================
" {{{ GUTTER
" https://github.com/airblade/vim-gitgutter/commit/8db2fc5
" =========================================================================
set number
set numberwidth=4 " gutter columns

if has ( 'signs' ) " https://vimdoc.sourceforge.net/htmldoc/sign.html
  " https://github.com/vim/vim/commit/394c5d8870b15150fc91a4c058dc571fd5eaa97e
  set signcolumn=yes " [auto|number|yes|no|off]
endif

" }}}

" =========================================================================
" {{{ STATUS
" Word Count - https://vimtricks.com/p/count-words-and-lines
"   - <C-g> - short format
"   - g<C-g> - extended format
"   - Status line - https://cromwell-intl.com/open-source/vim-word-count.html
" =========================================================================
set showmode " in status Vi (not Vim)
set shortmess= " Verbose command messaging
set shortmess-=S " Show search count
set laststatus=2 " Always show status line
if has ( 'win32' ) | set shortname=on | end

" https://vi.stackexchange.com/a/27508
set ruler " set cursor coordinates
set rulerformat=📏%P⏬%l⏩%c%V " overridden by statusline

set statusline=%#Statement# " initialize highlight group

" buffer number
set statusline+=﹟%n\ 
" git changes
set statusline+=%{%g:GitChanges()%}
" file type
set statusline+=💻%Y\ 

" mode
set statusline+=%{(mode()=~#'^c')?'💲':''} " Command
set statusline+=%{(mode()=~#'^i')?'📝':''} " Insert
set statusline+=%{(mode()=~#'^n')?'📄':''} " Normal
set statusline+=%{(mode()=~#'^R')?'📃':''} " Replace

set statusline+=%{(mode()=~#'^V')?'🔎':''} " Visual Line
" https://gnu.org/software/grep/manual/html_node/Character-Classes-and-Bracket-Expressions.html
set statusline+=%{(mode()=~#'^[[:cntrl:]]')?'🔍':''} " Visual Block ()

" full file name
set statusline+=%-4.15F%m

" TODO: Remove (Guten)Tags dependency
if &runtimepath =~ 'gutentag'
  set statusline+=%{gutentags#statusline_cb(function('TagsStatus'))}
endif

" flags
set statusline+=\ %r%h
" change to default highlight
set statusline+=\ %#StatusLine#\ 
" percentage
set statusline+=%-7((%p%%)⇳%)
" cursor line, total lines
set statusline+=%L☰LOC
" breakpoint
set statusline+=\ %<
" align right
set statusline+=%=
" cursor column position
set statusline+=%5(%4l⇩%)✖%-8.(⇨%-c%-V%)
" Show Command
set statusline+=\|%1.(%k%)
" Show Control Character Value
set statusline+=\|%-2(%S%)
" Show Cursor Character Values
set statusline+=%{CursorCharacter()}

set statusline+=%< " breakpoint
set statusline+=%#Normal# " set highlight

" formatoptions
set statusline+=\ 📜\ %{&fo}
" show colorscheme on statusline
set statusline+=\ 🎨\ %{get(g:,'colors_name','NONE')}\ 

" }}}

" =========================================================================
" {{{ MAPPINGS
"  - :help ga
"  - https://vi.stackexchange.com/q/16161
"  - https://vi.stackexchange.com/q/2089
"  - https://vi.stackexchange.com/q/7722/how-to-debug-a-mapping

" set a map leader for more key combos
" - https://stackoverflow.com/q/1764263/what-is-the-leader-in-a-vimrc-file
" " https://stevelosh.com/blog/2010/09/coming-home-to-vim/#using-the-leader
" - https://subscription.packtpub.com/book/data/9781789341096/3/ch03lvl1sec26/the-leader-key
let g:mapleader = ','

" :h modifyOtherKeys
" let &t_TI = ''
" let &t_TE = ''
" let &t_TI = '[>4;2m'
" let &t_TE = '[>4;m'
echom 'modifyOtherKeys: t_TI='..&t_TI..' t_TI='..&t_TE

" =========================================================================
" Map semi-colon to colon (no need to press <SHIFT>)
nnoremap ; :

" Splits
nnoremap _ :split<CR>
nnoremap <Bar> :vsplit<CR> :wincmd l<CR>

" <CTRL+h> Focus on pane to left
nnoremap <C-h> <C-w>h
" <CTRL+j> Focus on pane down
nnoremap <C-j> <C-w>j
" <CTRL+k> Focus on pane up
nnoremap <C-k> <C-w>k
" <CTRL+l> Focus on pane to right
nnoremap <C-l> <C-w>l

" Equal sized panes
nnoremap = <C-w>=
" Maximize pane (tmux zoom)
nnoremap <C-z> <C-w>_ \| <C-w>\|

" :Bdelete menu<CR>
nnoremap <Del>          x
nnoremap <Del>          x

nnoremap <Tab>          :Tab<CR>
nnoremap <Space>        :Space<CR>
nnoremap <Enter>        :Enter<CR>
nnoremap <C-f>          :Search<CR>

nnoremap <S-Tab>        :echom 'SHIFT + TAB'<CR>
nnoremap <Tab><Enter>   :echom 'TAB + ENTER'<CR>
nnoremap <Enter><Tab>   :echom 'ENTER + TAB'<CR>
nnoremap <Tab><Space>   :echom 'TAB + SPACE'<CR>
nnoremap <Space><Tab>   :echom 'SPACE + TAB'<CR>
nnoremap <Space><Enter> :echom 'SPACE + ENTER'<CR>
nnoremap <Enter><Space> :echom 'ENTER + SPACE'<CR>

" TODO: don't clobber Tab
" inoremap <Tab> <C-o>:echom 'INSERT TAB'<CR>
inoremap <Tab><Enter>   <C-o>:echom 'INSERT TAB + ENTER'<CR>
inoremap <Enter><Tab>   <C-o>:echom 'INSERT ENTER + TAB'<CR>
inoremap <Tab><Space>   <C-o>:echom 'INSERT TAB + SPACE'<CR>
inoremap <Space><Tab>   <C-o>:echom 'INSERT SPACE + TAB'<CR>
inoremap <Space><Enter> <C-o>:echom 'INSERT SPACE + ENTER'<CR>
inoremap <Enter><Space> <C-o>:echom 'INSERT ENTER + SPACE'<CR>

" TODO: FIX ECHO MESSAGE PRINTING TO COMMAND LINE
nnoremap <silent> <C-c> :if v:hlsearch \| nohlsearch \| endif <CR>
nnoremap <Leader>? :h index<CR>
nnoremap <Leader>/ :verbose map<CR>

" tabs
nnoremap <silent> L :tabnext<CR>
nnoremap <silent> H :tabprevious<CR>

" TODO: Prevent overriding <C-o> & C-t>
"   - https://stackoverflow.com/q/27588664/difference-between-c-t-and-c-o-in-vim
" Open Url on this line with the browser \w
cnoremap <C-o> :call Browse ()<CR>
" tabs - https://gist.github.com/Starefossen/5957088
" TODO: <C-t> conflicts with :tab pop

nnoremap <silent><Tab><Del> :Bwipeout menu<CR>

" current buffer in new (t)ab
nnoremap <Leader>t <C-w>t
" TODO: Determine if the following two commands work
" simulate break pane in TMUX
nnoremap <C-w>t :tab split<CR>
" All buffers into tabs
nnoremap <C-w>T :tabo<CR> :bufdo tab split<CR>

" normal mode: save
nnoremap <C-s> :update<CR> :echo 'Updated'<CR>
" visual mode: escape to normal and update
vnoremap <C-s> <C-c>:update<CR> :echo 'Updated'<CR>
" insert mode: escape to normal and save
inoremap <C-s> <C-o>:write<CR><C-o>:echo 'Updated'<CR>

" https://vimhelp.org/terminal.txt.html
if has ( 'terminal' )
  " set termwinkey=<Esc> " TODO: fix ESC key in Termux
  set termwinkey=<C-w> " The key that starts a CTRL-W command in a terminal window.
  nnoremap <S-t> :terminal<CR>

  " :h terminal
  autocmd VimDefaults TerminalWinOpen echo 'Terminal Window Open'
  " setlocal bufhidden=hide
endif

" Reload .vimrc configuration
" nnoremap <Leader>R :source ~/.vimrc
cnoremap <C-r> :source ~/.vimrc<CR>

" }}}

" =========================================================================
" {{{ FILES
"   - Tagbar C-Tags https://github.com/preservim/tagbar/wiki
"   - Per type configuration - https://vimtricks.com/p/per-file-type-configs
"   - autocommands - https://gist.github.com/romainl/6e4c15dfc4885cb4bd64688a71aa7063
" =========================================================================
let g:blacklist = [ 'nofile', 'help', 'terminal', 'startify' ] " filetypes

set autoread " re-read files
set noautowrite " do not autowrite
set noautowriteall " do not autowrite (all)
set nofixendofline " Disable <EOL> insertion

" Indentation ------------------------------------
set smarttab " 'tab' insertion
set autoindent   " auto(matically smart)indent
set copyindent   " copy previous line indentation
set breakindent  " break with existing line indent
" TODO: remove set smartindent  " indent based off current line on load
filetype indent on " filetype - https://vimdoc.sourceforge.net/htmldoc/filetype.html

" Meta-chars ------------------------------------
set fillchars+=fold:↯,foldopen:-,foldclose:+,foldsep:↯
set fillchars+=stl:▲,stlnc:\ ,vert:‖,diff:-,eob:𝕏,lastline:▶

" Format Options ------------------------------------
set joinspaces " Add two spaces after punctuation

" https://vimdoc.sourceforge.net/htmldoc/change.html#fo-table
set formatoptions=   " reset
set formatoptions+=c " autowrap `c`omments (with leader)
set formatoptions+=j " Delete joining line comment
set formatoptions+=l " preserve existing lines
set formatoptions+=n " Format numbered lists
set formatoptions+=o " Preserve o/O insert comments
set formatoptions+=q " autowrap comments with gq program
set formatoptions+=r " Preserve comment on CRLF newline
set formatoptions+=t " autowrap using `t`extwidth
set formatoptions+=/ " do not insert // leader unless after statement unless BOL
set fileformats=unix,dos " set <LF> (unix) first, then try <CR><LF> (DOS)

" -------------------------------------------------------------------------
" Omni-Complete
"  - See $VIMRUNTIME/autoload/*
"  - https://vim.fandom.com/wiki/Omni_completion
"  - Defaults - https://github.com/vim/vim/tree/master/runtime/autoload
" -------------------------------------------------------------------------
autocmd FileDefaults VimEnter * set omnifunc=syntaxcomplete#Complete

" -------------------------------------------------------------------------
" Tar - https://vi.stackexchange.com/a/2224
" -------------------------------------------------------------------------
let g:loaded_tar = 1
let g:loaded_tarPlugin = 1

" -------------------------------------------------------------------------
" Zip - https://vi.stackexchange.com/q/2223/how-to-tell-vim-not-to-try-to-unzip-a-file
" -------------------------------------------------------------------------
let g:loaded_zip = 1
let g:loaded_zipPlugin = 1

" -------------------------------------------------------------------------
" .vimrc - https://vimhelp.org
" -------------------------------------------------------------------------
" Autoload .vimrc on write
autocmd FileDefaults BufWritePost $MYVIMRC nested source $MYVIMRC

" -------------------------------------------------------------------------
" .tmux.conf - https://man7.org/linux/man-pages/man1/tmux.1.html
" -------------------------------------------------------------------------
" Autoload .tmux.conf on write
autocmd FileDefaults BufWritePost .tmux.conf
  \ echom 'Loading TMUX Configuration'
  \| call system ( 'tmux source-file "$HOME/.tmux.conf"' )
  \| call system ( 'tmux display-message "Source file loaded! (#{config_files})"' )

" -------------------------------------------------------------------------
" CSV - https://github.com/chrisbra/csv.vim
" -------------------------------------------------------------------------
autocmd FileDefaults BufNewFile,BufReadPost *.csv,*.dat call g:CSV ()

function g:CSV () abort
  setfiletype csv

" let l:csv_arrange_align = 'l*'

  ArrangeColumn

  echom 'loaded CSV (See https://github.com/chrisbra/csv.vim)'
  let g:csv_highlight_column = 'y'
endfunction " CSV

" -------------------------------------------------------------------------
" Markdown - http://vimcasts.org/episodes/hard-wrapping-text
" -------------------------------------------------------------------------
augroup FileDefaults
  autocmd BufNewFile,BufReadPost *.md setlocal formatoptions-=t formatoptions+=n
  autocmd BufNewFile,BufReadPost README setlocal formatoptions-=t formatoptions+=n
augroup END

" -------------------------------------------------------------------------
" XML - See $VIMRUNTIME/autoload/xmlcomplete.vim
" -------------------------------------------------------------------------
autocmd FileDefaults FileType xml setlocal omnifunc=xmlcomplete#CompleteTags

" -------------------------------------------------------------------------
" HTML - https://vimtricks.com/p/vim-autocomplete-html-tags
" -------------------------------------------------------------------------
autocmd FileDefaults FileType html,eruby setlocal omnifunc=htmlcomplete#CompleteTags

" Slim - https://github.com/slim-template/vim-slim
autocmd FileDefaults BufNewFile,BufReadPost *.slim setlocal filetype=slim

" -------------------------------------------------------------------------
" CSS - https://simplified.guide/vim/auto-complete-css
" -------------------------------------------------------------------------
augroup FileDefaults
  autocmd FileType css setlocal omnifunc=csscomplete#CompleteCSS
  autocmd BufNewFile,BufReadPost *.css,*.sss,*.sass,*.scss call g:CSS ()
augroup END

function! g:CSS () abort
  match WarningMsg /-\(moz\|webkit\|o\|ms\)-/

  setlocal filetype=css
  if &runtimepath !~ 'vim-css3-syntax' | return | endif

  if &runtimepath !~ 'tagbar' | return | endif

  let g:tagbar_type_css = {
  \ 'ctagstype' : 'Css',
    \ 'kinds' : [
      \ 'c:classes',
      \ 's:selectors',
      \ 'i:identities'
    \ ]
  \ } " tagbar_type_css
endfunction " g:CSS

" -------------------------------------------------------------------------
" Go
" -------------------------------------------------------------------------
autocmd FileDefaults FileType go setlocal omnifunc=syntaxcomplete#Complete

" -------------------------------------------------------------------------
" PHP - https://simplified.guide/vim/auto-complete-php
" -------------------------------------------------------------------------
autocmd FileDefaults FileType php setlocal omnifunc=phpcomplete#CompletePHP

" -------------------------------------------------------------------------
" Python - https://simplified.guide/vim/auto-complete-python
" -------------------------------------------------------------------------
autocmd FileDefaults FileType python setlocal omnifunc=python3complete#Complete

" -------------------------------------------------------------------------
" Javascript - https://simplified.guide/vim/auto-complete-javascript
" -------------------------------------------------------------------------
augroup FileDefaults
  autocmd FileType javascript setlocal omnifunc=javascriptcomplete#CompleteJS
  autocmd BufNewFile,BufReadPost *.js,*.es,*.mjs setlocal filetype=javascript
augroup END

" -------------------------------------------------------------------------
" Nodejs - https://simplified.guide/vim/auto-complete-javascript
" -------------------------------------------------------------------------
autocmd FileDefaults BufNewFile,BufReadPost * call s:DetectNode ()

function! s:DetectNode ()
  if getline ( 1 ) !~ 'node' | return | endif

  setlocal filetype=javascript
  setlocal omnifunc=javascriptcomplete#CompleteJS
endfun

" -------------------------------------------------------------------------
" Ruby - https://stackoverflow.com/q/15720313/vim-omnicomplete-with-ruby-only-partially-works/22805517#22805517
" -------------------------------------------------------------------------
augroup FileDefaults
  autocmd BufNewFile,BufReadPost *.erb :setlocal filetype=eruby
  autocmd BufNewFile,BufReadPost Gemfile :setlocal filetype=ruby
  autocmd BufNewFile,BufReadPost Rakefile,*.rake :setlocal filetype=rake
  autocmd FileType ruby,rake setlocal omnifunc=rubycomplete#Complete
augroup END

let g:tagbar_type_ruby = {
\ 'ctagsbin' : 'ripper-tags',
\ 'ctagsargs'  : [ '-f', '-' ],
\ 'scope2kind' : { 'class' : 'c' },
\ 'kind2scope' : { 'c' : 'class', 'm' : 'class' },
\ 'kinds' : [
  \ 'a:aliases',
  \ 'f:methods',
  \ 'm:modules',
  \ 'c:classes',
  \ 'C:constants',
  \ 'd:describes',
  \ 'F:singleton methods'
\ ] } " g:tagbar_type_ruby

" }}}

" =========================================================================
" {{{ FUNCTIONS
"  - https://tecmint.com/bash-scripts-linux-sysadmin
" =========================================================================
let shazam='Bar'
function Foo{g:shazam} () abort
  echom 'Shazzaaaam'
endfunction

command! Tab call s:tab ()
function! s:tab () abort
  echom 'Tabbbbbiiiiing'
  " Call (User) completefunc
  execute "normal! \<C-x>"
endfunction " tab

command! Space call s:space ()
function! s:space () abort
  echom 'Spacing ( Not Yet Implemented. See :Space command )'
endfunction " space

command! Enter call s:enter ()
function! s:enter () abort
  echom 'Entering ( Not Yet Implemented. See :Enter command )'
endfunction " enter

autocmd UserDefaults CursorHoldI * :Idle
command! Idle call s:idle ()
function! s:idle () abort
  echom 'Idling ( Not Yet Implemented. See :Idle command )'
endfunction " idle



finish



" -------------------------------------------------------------------------
" Define () - current word
"   - Dictionary
" -------------------------------------------------------------------------
command -bang -nargs=? -complete=custom,Complete Define call s:define ( <bang>0, <f-args> )
function s:define ( ... ) " abort
  echom 'define ():'
  const l:bang = get ( a:, 1, v:false )
  const l:term = get ( a:, 2, expand ( '<cword>' ) )

  echom 'argument count:' argc ()
  echom 'bang:' l:bang

  let @/ = l:term

  echom '"' .. l:term .. '"'
endfunction " define

" -------------------------------------------------------------------------
" Thesaurus
"   - Moby - https://gutenberg.org/iles/3202/mthesaur.txt
" -------------------------------------------------------------------------
nnoremap <leader>t g:Thesaurus ()

autocmd VimDefaults VimEnter * call g:Thesaurus ()

function! g:Thesaurus () abort
  let l:path = expand ( '$HOME/mthesaur.txt' )
  if !!! filereadable ( path ) | return | endif

  " https://github.com/vim/vim/issues/1611
  " https://thesynack.com/posts/vim-thesaurus
  echom 'setting thesaurus to' path
  set thesaurus=path " https://stackoverflow.com/q/33453468

" let s:saved_ut = &ut
" if &ut > 200 | let &ut = 200 | endif
" augroup ThesaurusAuGroup
"   autocmd CursorHold,CursorHoldI <buffer>
"     \ let &ut = s:saved_ut |
"     \ set iskeyword-=32 |
"     \ autocmd! ThesaurusAuGroup
" augroup END
" return ":set iskeyword+=32\<cr>vaWovea\<c-x>\<c-t>"
endfunction " Thesaurus

" -------------------------------------------------------------------------
" Search () - in buffers, windows, tabs, tags, scopes
"   - :help @/
" -------------------------------------------------------------------------
set hlsearch
command! -bang -nargs=? -complete=customlist,s:fuzz Search call s:search ( <bang>0, <f-args> )
function! s:search ( ... ) abort
  echom 'search ():'
const l:bang = get ( a:, 1, v:false )
  const l:term = get ( a:, 2, expand ( '<cword>' ) )

  echom 'argument count:' argc ()
  echom 'bang:' l:bang

  let @/ = l:term

  echom '"' .. l:term .. '"'
endfunction " search

function s:fuzz ( ... ) abort
  const l:term = get ( a:, 1, expand ( '<cword>' ) )

  echom 'This is the -complete=func' l:term
  echom a:000

  return [ 'shaaa', 'zaaaaam' ]
endfunction " fuzz

" -------------------------------------------------------------------------
" Find () - in buffer
"   - :help ascii
" -------------------------------------------------------------------------
" :h finddir()
" :h findfile()
command! -bang -nargs=* -complete=custom,Complete Find call s:find ( <bang>0, <f-args> )
function! s:find ( ... ) abort
  echom 'find ():'
  const l:bang = get ( a:, 1, v:false )
  const l:term = get ( a:, 2, expand ( '<cword>' ) )

echom 'argument count:' argc ()
  echom 'bang:' l:bang

  let @/ = l:term

  echom '"' .. l:term .. '"'

  set showtabpanel=1 " show
endfunction " find

" -------------------------------------------------------------------------
" Locate () - in files
" -------------------------------------------------------------------------
command -bang -nargs=* -complete=file_in_path Locate call s:locate ( <bang>0, <f-args> )
function s:locate ( ... ) " abort
  echom 'locate ():'
  const l:bang = get ( a:, 1, v:false )
  const l:term = get ( a:, 2, expand ( '<cword>' ) )

  echom 'argument count:' argc ()
  echom 'bang:' l:bang

  echom '"' .. l:term .. '"'
endfunction " define

" -------------------------------------------------------------------------
" Lookup () - ??????
" -------------------------------------------------------------------------
command -bang -nargs=* -complete=custom,Complete Lookup call s:lookup ( <bang>0, <q-args> )
function s:lookup ( ... ) " abort
  let l:tags = []
  let l:tag  = 'module'
  let l:kinds  = [ 'f', 'function', 'method', 'F', 'singleton method' ]

  echom 'argument count:' argc ()

  let i = 0
" while i < argc ()
    echom 'Argument (' .. 1 .. '):' argv ( 0 )
"   i=i+1
" endwhile


  for entry in taglist ( '^' .. tag )
    if index ( [ 'f' ], entry.kind ) > 1
      call add ( tags, entry )
    endif
  endfor

  echom 'Tags:' join ( tags, ', ' )
  echom 'Git root:' system ( 'git rev-parse --show-toplevel' )

  return

  call complete ( col ( '.' ), [
  \ 'January', 'February', 'March', 'April', 'May', 'June',
  \ 'July', 'August', 'September', 'October', 'November', 'December'
  \ ])

  return ''
endfunction " Lookup

" -------------------------------------------------------------------------
" PopUp () - https://vimhelp.org/popup.txt.html
" -------------------------------------------------------------------------
function! Popup () abort
  const l:choices = [ 'Suggestion #1', 'Suggestion #2', 'Suggestion #3' ]

  call popup_menu ( l:choices
    \, #{ highlight: 'WildMenu', borderhighlight: [ 'WildMenu' ], border: [], borderchars: [ '•' ]
    \, padding: [ 1,1,0,1 ], close: 'button', scrollbar: 'TRUE', resize: 'FALSE', drag: 'TRUE', wrap: 'FALSE'
    \, title: '• devPunks😈Studio •', filtermode: 'a', zindex: 1, pos: 'botleft', col: 'cursor+1', callback: 'PopupComplete' })
endfunction " Popup

function! PopupComplete ( id, result ) abort
  echom 'Hot Damn' a:id a:result
endfunction " PopupComplete

" -------------------------------------------------------------------------
" Browse ()
" -------------------------------------------------------------------------
function! Browse ( ... ) abort " Opening URL
  const l:open = 'open ' " Default
  " const l:open = 'xdg-open ' executable('xdg-open')
  " const l:open = 'start ' has('win16') has('win32') has('win64')
  " const l:open = 'open ' has('mac') has('macunix') has('gui_macvim')

  const url = get ( a:, 1, getline ('.') ->matchstr( 'http[^ ]*' ) )

  if empty ( url ) | return | endif

  echom 'Opening URL:' url
  call system ( l:open .. url )

endfunction " Browse

" -------------------------------------------------------------------------
" CursorCharacter ()
"   - :help ascii
"   - https://stackoverflow.com/q/20357800
"   - https://en.wikipedia.org/wiki/Unicode
"   - https://geeksforgeeks.org/program-decimal-octal-conversion
"   - https://unicode.org/mail-arch/unicode-ml/y2005-m11/0060.html
" -------------------------------------------------------------------------
function! CursorCharacter () abort " DecimalToOctal(27)
  const l:char = strpart ( getline ( '.' ), col ( '.' ) -1, 1, 1 )
  const l:index = char2nr ( char ) " char(acter) to number
  const l:character = printf ( '|%-2s', char )

  " Formal Hexadecimal Unicode Notation (Code Point)
  " - https://en.wikipedia.org/wiki/UTF-8
  " - https://en.wikipedia.org/wiki/UTF-16
  " - https://en.wikipedia.org/wiki/Hexadecimal
  " - https://en.wikipedia.org/wiki/Percent-encoding (e.g. %20)
  const l:hexadecimal = printf ( '|U+%-7s' , printf( '%04X', index ) )
  " Formal Decimal HTML Entity (Code Point) - https://en.wikipedia.org/wiki/Code_point
  const l:decimal = printf ( '|&#%-7s', printf ( '%d;', index ) )
  " Octal (Code Point) - https://en.wikipedia.org/wiki/Numeric_character_reference
  const l:octal = printf ( '|\0o%-6o', index )

  " Join character to escape sequences
  " - https://en.wikipedia.org/wiki/Escape_sequence
  return character .. [ decimal, hexadecimal, octal ] ->join( ' ' )
endfunction " CursorCharacter

" -------------------------------------------------------------------------
" GetColor (group, attribute)
"   - https://reddit.com/r/neovim/comments/oxddk9
" -------------------------------------------------------------------------
function! GetColor ( group, attr ) abort " GetColor ( 'LineNr', 'bg#' )
  let color = synIDattr ( synIDtrans ( hlID ( a:group ) ), a:attr )

  echom 'THE COLOR' color

  return color ? color : 'NONE'
endfunction " GetColor

" -------------------------------------------------------------------------
" :HighlightGroup () under cursor
" -------------------------------------------------------------------------
" https://vim.fandom.com/wiki/Identify_the_syntax_highlighting_group_used_at_the_cursor
" https://gist.github.com/millermedeiros/1262085/d6376a5cd6b13ba4573abe0f45a458bf6ae596b7#file-gistfile1-vim-L306
command! Colors call HighlightGroup ()
function! HighlightGroup () abort
    let l:s = synID ( line ( '.' ), col ( '.' ), 1 )

    echom synIDattr ( l:s, 'name' ) ' -> ' synIDattr ( synIDtrans ( l:s ), 'name' )
endfunction " HighlightGroup

" -------------------------------------------------------------------------
" TabLine () :h(elp) setting-tablines
" -------------------------------------------------------------------------
function! TabLine () abort
  if !!! exists ( '+showtabline' ) | return '' | endif

  " mouse
  let l:mouse="%{ empty ( &mouse ) ? '    ' :  '  🐭' }"

  let l:line = l:mouse
  let l:line ..= ' devPunks😈studio %#TabLine#' " logo

  let l:tabs = range ( tabpagenr ( '$' ) )
  for index in l:tabs
    let l:tab = index + 1
    let l:count = tabpagewinnr( tab,'$' )
    let l:window = tabpagewinnr( l:tab )
    let l:buffers = tabpagebuflist( l:tab )
    let l:index = l:buffers[ l:window - 1 ]
    let l:name = bufname( l:index )
    let l:modified = getbufvar( l:index, '&mod' )

    " set tab page number (for mouse clicks)
    let l:line ..='%' .. ( l:tab ) .. 'T'
    let l:line ..= ( l:tab == tabpagenr() ? '%#TabLineSel#| ▼ ' : '%#TabLine#')
    let l:line ..= ( l:tab == tabpagenr() || l:tab == tabpagenr() +1 ? ' ' : '| ' )
    let l:line ..= ( l:tab == tabpagenr() ? '✎' : '')
    let l:line ..= ( l:name == '' ?  '[No Name]' : fnamemodify (l:name, ':t' ) )
    let l:line ..= ( l:modified ? '➕' : '' )
    let l:line ..= ( l:count > 1 ? ' ⊞'.l:count : '' )

    let l:others = ( len( l:tabs ) > 1 )
    let l:current = ( l:tab == tabpagenr() )
    " Close button
    " let line ..= '%=%999X%#TabLineSel#[X]' " Right justified on TabLine
    let l:line ..= ( l:others && l:current ? '%' .. (l:tab) .. 'X ❌%X' : '' )
    " Closing gliph
    let l:line ..= ( l:current ? ' ▼ ' : ' ' )

    let l:line ..= ( l:current || l:tab == len ( l:tabs ) ? '|' : '' )
    let l:line ..= '%T' " Tab delineation
  endfor

  let l:line ..= '%<' " Overflow breakpoint
  let l:line ..= '%#TabLineFill#' " Tablist breakpoint

  return l:line
endfunction " TabLine

" }}}

" =========================================================================
" {{{ PLUGINS - check loaded with &runtimepath =~ 'plugin-name'
" =========================================================================

echom 'All Plugins'
" scriptnames " List all loaded plugins

filetype plugin on " filetype - https://vimdoc.sourceforge.net/htmldoc/filetype.html


" -------------------------------------------------------------------------
" git_link - https://iautom8things/gitlink-vim
" -------------------------------------------------------------------------
command! -range Link call s:git_link ( <line1>, <line2> )
function s:git_link ( start, end ) range " a:firstline a:lastline
  " Visual Line || Visual Block () || Line #
  " let l:line = ( mode () =~# '^V' || mode () =~# '^[[:cntrl:]]' )
  "   \ ?  '#L' .. line ( "'<" ) " Visual Start Line
  "   \ .. '-L' .. line ( "'>" ) " Visual Ene Line
  "   \ : '#L' .. line ( '.' ) " Default
  let l:line =
    \ '#L' .. get ( a:, 'start', line ( '.' ) ) ..
    \ '-L' .. get ( a:, 'end', line ('.' ) )
  let l:hash = system( 'git rev-parse HEAD 2>/dev/null' )
    \ ->substitute( '\n', '', 'g' ) " --abbrev-ref for short commit sha

  if v:shell_error | return | endif

  if system ( 'git ls-files ' .. expand ( '%:p' ) )
    \ ->substitute( '\n', '', 'g' )->empty() | return | endif

  if !!! system ( 'git diff ' .. expand ( '%:p' ) )
    \ ->substitute( '\n', '', 'g' )->empty() | return | endif

  let l:root = system( 'git rev-parse --show-toplevel' )
    \ ->substitute( '\n', '', '' )
  let l:path = expand( '%:p'  )->substitute( l:root, '', '' )
    \ ->substitute( '\n', '', 'g' )

  let l:remote = system ( 'git config --get remote.origin.url' )
    \ ->substitute( '^ssh://', 'https://', '' )
    \ ->substitute( '^git@', 'https://', '' )
    \ ->substitute( '^git:', 'https://', '' )
    \ ->substitute( '.com:', '.com/', '' )
    \ ->substitute( '\.git', '', '' )
    \ ->substitute( '\n', '', 'g' )

  let l:url = l:remote .. '/tree/' .. l:hash .. l:path .. l:line

  echom 'The Hash:' l:hash
  echom 'The Line:' l:line
  echom 'The Root:' l:root
  echom 'The Path:' l:path
  echom 'The Remote:' l:remote
  echom 'The URL:' l:url

  call Browse ( l:url )

endfunction " git_link

" -------------------------------------------------------------------------
" git-blame - https://git-scm.com/docs/git-blame
" -------------------------------------------------------------------------
" autocmd VimDefaults CursorHold * :Blame

function Baz ( ... )
  echom 'Baz'
endfunction

command! Blame echo s:blame ()
function s:blame () abort
  let options = { 'foo' : 'bar' }

  call timer_start ( 3000, { -> execute ( 'call Baz ()' ) } )
  return v:shell_error

  let l:file = expand('%:p')

  " Check if command exists
  call system ( 'command -v git' )
  if v:shell_error | return | endif

  if !!! filereadable ( l:file ) | return '' | endif

  let l:blame = split ( system ( 'command git --no-pager blame '
    \ .. '"$(basename "' .. l:file .. '")" -L ' .. line ('.') .. ',+1 --porcelain' ), '\n' )
  if v:shell_error | return | endif

  if blame[0] =~# '^0000\+' | return '⚠️ Not Committed Yet ⚠️' | endif

  let l:hash = '#' .. matchstr ( blame[ 0 ], '^\^*\zs\S\+' )
  let l:author = '👤' .. matchstr ( blame[ 1 ], '^author \zs.\+$' )
  let l:author_mail = '📧' .. matchstr ( blame[ 2 ], '^author-mail \zs.\+$' )
  let l:author_time = '🕓' .. strftime ( '%Y-%m-%d %X',
    \ matchstr ( blame[ 3 ], '^author-time \zs.\+$' ) )

  for line in l:blame
    if line !~# '^summary' | continue | endif
    let l:summary = '✒' .. matchstr ( line, '^summary \zs.\+$' )
  endfor

  return join ( [ l:hash[:7], l:author, l:author_mail, l:author_time, l:summary ], ' ' )
endfunction " blame

" -------------------------------------------------------------------------
" Startify - https://github.com/mhinz/vim-startify
"   - :h startify
"   - :h startify-faq
" -------------------------------------------------------------------------
autocmd VimDefaults VimEnter call g:Start ()

function! g:Start () abort
  echom 'Calling Startify'
  if &runtimepath !~ 'startify' | return | endif

  let g:startify_padding_left = 5
  let g:startify_session_sort = 0
  let g:startify_files_number = 20
  let g:startify_session_dir = getcwd()
  let g:startify_session_persistence = 1
  let g:startify_session_before_save = []
  let g:startify_custom_footer = ['😈', 'devPunks😈Studio', '😈']
  let g:startify_custom_header = 'startify#center(startify#fortune#boxed())'
  let g:startify_custom_indices = map(range(1,100), 'string(v:val)') " start from 1
  let g:startify_commands = [
    \ { 't': [ 'Tags', 'call Tag()' ] },
    \ { 'v': [ 'Edit .vimrc', 'tabnew $HOME/.vimrc' ] },
    \ { 'b': [ 'Edit .bashrc', 'tabnew $HOME/.bashrc' ] },
    \ { 'l': [ 'Edit .bash_login', 'tabnew $HOME/.bash_login' ] },
    \ { 's': [ 'LSP (Language Server Protocol)', 'call LSP()' ] },
    \ ]

  let g:startify_lists = [
    \ { 'type': 'commands',  'header': [ 'Commands' ]      },
    \ { 'type': 'bookmarks', 'header': [ 'Bookmarks' ]     },
    \ { 'type': function('s:NerdtreeBookmarks'), 'header': [ 'NERDtree Bookmarks' ] },
    \ { 'type': function('s:gitModified'),  'header': [ 'git modified' ] },
    \ { 'type': 'dir',       'header': [ 'MRU', getcwd() ] },
    \ { 'type': 'files',     'header': [ 'MRU' ]           },
    \ { 'type': 'sessions',  'header': [ 'Sessions' ]      },
    \ ]
endfunction " Start

function! s:gitModified () abort
  let l:files = systemlist ( 'git ls-files -m 2>/dev/null' )

  echo 'startify gitModified'
  return map( l:files, "{ 'line': v:val, 'path': v:val }" )
endfunction " gitModified

function! s:NerdtreeBookmarks() abort
  let l:bookmarks = systemlist ( "cut -d' ' -f 2- ~/.NERDmarks" )
  let l:bookmarks = bookmarks[0:-2] " Slice empty last line

  echo 'startify NERDTreeBookmarks'
  return map ( l:bookmarks, "{ 'line': v:val, 'path': v:val }" )
endfunction " NerdtreeBookmarks

" -------------------------------------------------------------------------
" OverflowMargin - http://blog.ezyang.com/2010/03/vim-textwidth
" -------------------------------------------------------------------------
augroup ViimDefaults
  autocmd VimResized * wincmd = " resize (see equalalways)
  autocmd FocusLost * :w " save on focus lost
augroup END

" (https://vi.stackexchange.com/a/15995)
" autocmd winEnter,BufEnter Double triggers event.
autocmd FileDefaults BufEnter * call OverflowMargin ()

function OverflowMargin () abort
  call clearmatches ()

  if ! &textwidth | return | endif

  " call matchadd('ColorColumn', '\%75v.*')
  call matchadd ( 'ColorColumn', '\%>' . &textwidth . 'v' )
  " https://baeldung.com/linux/vim-ruler-on-specific-column
  let &colorcolumn= ( &textwidth +1 ) .. ',' .. ( &textwidth +2 )
endfunction " OverflowMargin

" -------------------------------------------------------------------------
" Scrollbar - https://github.com/obcat/vim-sclow
" -------------------------------------------------------------------------
" autocmd FileReadPost * call sclow#update()
autocmd VimDefaults BufNewFile,BufReadPost * call g:ScrollBar ()

function! g:ScrollBar () abort
  if get( g:, 'loaded_sclow', 0 ) != 1 | return | endif

  echom 'Showing Scrollbar'

  let g:scrollbar_thumb = '⬜'
  let g:sclow_sbar_text = '⬜'
  let g:scrollbar_clear = '🔳'
  let g:sclow_bar_right_offset = -2

  " TODO: Remove
  SclowDisable
endfunction " g:ScrollBar

" -------------------------------------------------------------------------
" Vim Signature - https://github.com/kshenoy/vim-signature
" -------------------------------------------------------------------------
autocmd VimDefaults ColorScheme * call g:Marks ()

function! g:Marks () abort
  if !!! exists ( 'g:loaded_Signature' ) | return | endif

  echom 'Marking' expand ( '%' )

  let g:SignaturePurgeConfirmation = 1
  let g:SignatureDeleteConfirmation = 1

  highlight! link SignatureMarkText CursorLineNr
  highlight! link SignatureMarkLine CursorLineNr
  highlight! link SignatureMarkerText CursorLineNr
  highlight! link SignatureMarkerLine CursorLineNr

  autocmd FileDefaults BufEnter * :SignatureRefresh
endfunction " Marks

" -------------------------------------------------------------------------
" Vim (Git) Gutter - https://github.com/airblade/vim-gitgutter
" -------------------------------------------------------------------------
augroup FileDefaults
  autocmd BufReadPost * call g:GitGutter ()
  autocmd InsertEnter * call g:GitFocus ()
  autocmd InsertLeave * call g:GitBlur ()
augroup END

function! g:GitFocus () abort
  if ! has ( 'signs' ) || !!! exists ( 'g:loaded_gitgutter' ) | return '' | endif

  highlight! link GitGutterAdd DiffAdd
  highlight! link GitGutterChange DiffChange
  highlight! link GitGutterDelete DiffDelete

  GitGutterLineHighlightsEnable
endfunction " GitFocus

function! g:GitBlur () abort
  if !!! has ( 'signs' ) || !!! exists ( 'g:loaded_gitgutter' ) | return '' | endif

  highlight link GitGutterAdd NONE
  highlight link GitGutterChange NONE
  highlight link GitGutterDelete NONE

  GitGutterLineHighlightsDisable
endfunction " GitBlur

function! g:GitDiffs () abort
  let l:files = system ( 'git diff --shortstat' )
  let l:summary = '%#Statement# '

 echom 'Buffer Name:' bufname ( '' )
  if true | let l:summary ..= printf ( '%s', summary ) | endif
  let l:summary ..= '%#Statement# '

  return l:summary
endfunction " GitDiffs

function! g:GitChanges () abort
  if !!! has ( 'signs' ) || !!! exists ( 'g:loaded_gitgutter' ) | return '' | endif

  let [ a, m, r ] = GitGutterGetHunkSummary ()

  let l:summary = '%#Statement# '
  \ .. ( a ? printf ( '%%#DiffAdd# ➕%d '    , a ) : '' )
  \ .. ( m ? printf ( '%%#DiffChange# ➕%d ' , m ) : '' )
  \ .. ( r ? printf ( '%%#DiffDelete# ➕%d ' , r ) : '' )
  \ .. '%#Statement# '

  return l:summary
endfunction " GitChanges

function! g:GitGutter () abort
  if !!! has ( 'signs' ) || !!! exists ( 'g:loaded_gitgutter' ) | return | endif

  echom 'Git Gutter!'

  GitGutterEnable

  nnoremap <silent><buffer> ]h <Plug>(GitGutterNextHunk)
  nnoremap <silent><buffer> [h <Plug>(GitGutterPrevHunk)

  set foldtext=gitgutter#fold#foldtext()

  " disable difffing of plugis
  let g:gitgutter_git_args = ':!$HOME/.vim/start'
  let g:gitgutter_diff_args = ':!$HOME/.vim/start'

  let g:gitgutter_sign_priority = 1
  let g:gitgutter_sign_allow_clobber = 1
  let g:gitgutter_set_sign_backgrounds = 1

  sign define GitGutterLineAdded text=➕
  sign define GitGutterLineRemoved text=➖
  sign define GitGutterLineModified text=～

  let g:gitgutter_highlight_linenrs = 1
  let g:gitgutter_preview_win_floating = 1
  let g:gitgutter_terminal_reports_focus = 0

  let g:gitgutter_sign_added = 'xx'
  let g:gitgutter_sign_modified = 'yy'
  let g:gitgutter_sign_removed = 'zz'
  let g:gitgutter_sign_removed_first_line = '^^'
  let g:gitgutter_sign_removed_above_and_below = '{'
  let g:gitgutter_sign_modified_removed = 'ww'
endfunction " GitGutter

" -------------------------------------------------------------------------
" IndentGuides - https://github.com/preservim/vim-indent-guides
" -------------------------------------------------------------------------
autocmd VimDefaults VimEnter * call g:Indentation ()

function! g:Indentation () abort
" if &runtimepath !~ 'vim-indent-guides' | return | endif

  echom 'Loading indentation guides'
  let g:indent_guides_guide_size = 1
  let g:indent_guides_auto_colors = 0

  autocmd FileDefaults BufLeave *
    \ if &runtimepath =~ 'vim-indent-guides' | :IndentGuidesEnable | endif
  autocmd FileDefaults BufEnter *
    \ if &runtimepath =~ 'vim-indent-guides' | :IndentGuidesDisable | endif

  highlight IndentGuidesOdd guifg=darkgrey guibg=NONE ctermfg=darkgrey ctermbg=NONE
  highlight IndentGuidesEven guifg=darkgrey guibg=NONE ctermfg=darkgrey ctermbg=NONE

endfunction " indentation

" -------------------------------------------------------------------------
" Marks - https://vimhelp.org/motion.txt.html#mark-motions
"   :h mark
"   :h marks
"   - https://vim.fandom.com/wiki/Using_marks
"   - https://m.youtube.com/watch?v=ie97AjchXxY
" -------------------------------------------------------------------------
nnoremap <c-m> :marks<CR>

" -------------------------------------------------------------------------
" Tags :h tags-and-searches (tagsrch.txt)
"  :h tag <name>  " or from command line : /<name>
"  :h tags
"  :h ctags
"  :h tselect
"  :h tagstack
"  :h file-searching (for ;)
"  <C-]> jump to & push tag
"  <C-t> pop tag (:pop)
"  - https://github.com/alvan/vim-indexer
"  - https://en.m.wikipedia.org/wiki/Ctags
"  - https://github.com/universal-ctags/ctags
"  - https://linuxhint.com/integrating_vim_ctags
"  - https://vim.fandom.com/wiki/Browsing_programs_with_tags
"  - https://vimways.org/2018/you-should-be-using-tags-in-vim
"  - https://stackoverflow.com/q/17783539/tag-navigation-in-vim
"  - https://gist.github.com/olmokramer/20a3922f052b5c4e52a122e9a0ec8722
"  - https://andrewradev.com/2011/06/08/vim-and-ctags
"  - https://andrewradev.com/2011/10/15/vim-and-ctags-finding-tag-definitions
"  - https://vi.stackexchange.com/q/5206/enable-completion-for-css-using-ctags
"  - TODO: TAGSCOPE PLUGIN - https://stackoverflow.com/q/7932694/lookup-a-specific-kind-of-tag-in-vim#comment81747695_7932694
" -------------------------------------------------------------------------
  set tagstack
  set tagbsearch " disable if not sorted
  set tagfunc=TagFunc
  let &g:tags = findfile ( 'tags', '.;' )
  set tagcase=followscs " Follow smartcase & ignorecase

  set iskeyword+=-,. " a-z,A-Z,48-57,_,.,-,>

  echom 'Current Dir:' getcwd ()
  echom '(tags) definitions path:' &g:tags

function TagFunc ( pattern, flags, info ) abort
  echom 'TagFunc ():'
  let l:flag = get( {
  \ 'c': 'Command Line',
  \ 'i': 'Insert Mode',
  \ 'r': 'Regex Pattern' }, a:flags,
  \ 'Default Call Mode' )

  let l:insert = mode () == 'i'

  echom 'Insert:' l:insert
  echom 'Pattern:' a:pattern
  echom 'Flags:' a:flags
  echom 'Flag:' l:flag
  echom 'Info:' a:info

  " NOT ALLOWED TO CHANGE TAGSTACK
  let l:result = []
  echom 'Calling taglist ()'
  let l:results = taglist ( a:pattern )

  echom 'Found' len ( l:results ) 'Results'
  echom 'The Results:'
  echom join ( l:results, "\n\n" )

  return l:results
endfunction " TagFunc

augroup FileDefaults
  " autocmd BufNew  * " What to do when buffer is empty
  autocmd FileType  * :Tag!
  autocmd BufWritePost * :Tag!
augroup END

command! -bang -nargs=? -complete=filetype Tag call s:tag ( <bang>0, <f-args> )
function s:tag ( ... ) abort
  let l:bang = get ( a:, 1, v:false )
  let l:type = get ( a:, 2, &l:filetype )
  let l:root = fnamemodify (
    \ finddir ( '.git/..', expand ( '%:p:h' ) .. ';' .. $HOME )
    \ ?? $HOME , ':p' )
  let l:git = system( 'cd '.. getcwd () ..' && GIT_TRACE=0 git rev-parse --show-toplevel' )
    \ ->trim()


  function! s:read ( file ) closure
    echom 'Read Bang: ' l:bang

    if !!! l:bang | return [] | endif

    if !!! filereadable ( a:file ) | return [] | endif

    echom 'Reading' a:file 'tags without' expand ( '%:p' )

    return readfile ( a:file )
      \ ->filter( ' v:val =~ "^!_TAG" ' )
      \ ->filter( ' v:val =~ expand("%:p") ' )
  endfunction " read


  function! s:write ( tags = [] ) closure
    echom 'Write Bang:' l:bang

  if !!! l:bang | return | endif

    let l:headers = []
    let l:tags = a:tags
    let l:temp = tempname ()

    let l:excludes = split ( &wildignore, ',' )
      \ ->map( ' "--exclude=" .. v:val ' )

    " Adds (#) to search /#\1/
    " '--regex-css=/^[ \t]*#([A-Za-z0-9_-]+)/#\1/i,id,ids/',
    let l:flags = [ '--verbose --recurse --guess-language-eagerly',
    \ '--languages=' . l:type,
    \ '--langmap=vim:+.vimrc',
    \ '--regex-' . l:type . '=/(\"|#|<!--|\\/\\/)[ \\t]*(TODO|FIXME)/\\2/T,Todo,TODO & FIXME messages/i\',
    \ '--totals=yes --sort=foldcase --tag-relative=never --extras=+r --fields=+r --fields=+lknaS'
    \]

 "  \ '--langmap=ruby:+.erb\(Gemfile\)',
 "  \ '--langmap=markdown:.md\(README\)',
 "  \ '--langmap=sh:+.bashrc.bash_login.bash_profile.bash_logout',
 "  \ '--langmap=css:+.less.scss.sass.styl',
 "  \ '--langmap=javascript:+.es',
 "  \ '--langdef=dockerfile',
 "  \ '--langmap=dockerfile:+\(Dockerfile\)',
 "  \ '--regex-css=/^[ \t&]*#([A-Za-z0-9_-])( |$)/#\1/i,id,ids/',
 "  \ '--regex-markdown=/^(#+[ \t]+.*)/\1/h,heading,headings/',
 "  \ '--regex-html=/id="*([A-Za-z0-9_-]+)"*/#\1/i,id,ids/',
 "  \ '--regex-html=/class=[\"]*([A-Za-z0-9_-]+)[\"]*/.\1/c,class,classes/',
 "  \ '--regex-js=/([A-Za-z0-9._$]+)[ \t]*[:=][ \t]*{/1/o,object,objects/',
 "  \ "--regex-js=/([A-Za-z0-9._$()]+)[ \t]*[:=][ \t]*function[ \t]*(/1/,f,function,functions/",
 "  \ "--regex-js=/function[ \t]+([A-Za-z0-9._$]+)[ t]*(([^)]))/1/f,function,functions/",
 "  \ "--regex-js=/([A-Za-z0-9._$]+)[ \t]*[:=][ \t]*[/1/a,array,arrays/",
 "  \ "--regex-js=/([A-Za-z0-9._$]+)[ \t]*[:=][ \t]*[\"\']/1/s,string,strings/",
 "  \ '--regex-dockerfile=/^(FROM|MAINTAINER|RUN|CMD|LABEL|EXPOSE|ENV|ADD|COPY|ENTRYPOINT|VOLUME|USER|WORKDIR|ARG|ONBUILD|STOPSIGNAL|HEALTHCHECK|SHELL)/\1/d,dockerfile,dockerfiles/',
    let l:command = 'ctags '
      \ .. ( l:flags + l:excludes )->join()
      \ .. ' -o ' .. l:temp
      \ .. ' ' .. expand ( '%:p' )

    echom 'tempfile:' l:temp
    echom 'CTags Executable:' system ( 'command -v ctags' )
    echom 'The command $' l:command
    echom "\nWriting tags for" expand ( '%:p' )
    call system ( l:command )

    for line in readfile( l:temp )
      if line =~ '^!_TAG' | call add( l:headers, line ) | endif
      if line =~ expand("%:p") | call add( l:tags, line ) | endif
    endfor

    echom 'Writing 🏷️Tags to:' l:path
    " TODO: Write file only when contents has changed
    call writefile ( l:headers + l:tags, l:path )

    echom 'deleting tempfile:' l:temp
    call delete ( l:temp )
    echom
  endfunction " write


  if systemlist ( 'command ctags --list-languages' )
    \ ->map( ' tolower ( v:val ) ' )
    \ ->index( l:type ) < 0
  \ | return | endif

  echom 'Root:' l:root
  echom 'GIT root path:' l:git
  echom 'Found CTags language:' l:type
  echom 'Global tags (before):' &g:tags

  echom 'Current File:' expand ( '%:p' )

  let l:paths = []
  let l:file = findfile ( l:type .. '.tags', expand ( '%:p:h' ) .. ';' .. l:git )
        \ ?? l:git .. '/' .. l:type .. '.tags'
  if empty ( l:file ) | echom '⚠️ Generate CTags for ⋙ ' .. l:type | return | endif

  " TODO: Stop at project marker (i.e. .git, package.json, Gemfile)
  while ! empty ( l:file )
    echom '(' .. l:type .. ' tags) definitions path: '.. fnamemodify ( l:file, ':p' )
    call add ( l:paths, fnamemodify ( l:file, ':p' ) )
    let l:parent = fnamemodify ( l:file, ':p:h:h' )
    let l:file = findfile ( l:type .. '.tags', l:parent .. ';' .. l:git )
  endwhile

  " TODO: remove duplicates from parent in tagstack
  " The next file in the list is not used when:
  " - A matching static tag for the current buffer has been found.
  " - A matching global tag has been found.
  " l:paths = filter( l:paths, 'empty( v:val )' )
  let l:path = l:paths[ 0 ]

  echom 'paths:'
  echom l:paths

  echom '🏷️Tags path:' l:path
  call s:write ( s:read ( l:path ) )

  let &l:tags = l:paths->join( ',' )

  echom 'Global tags (after):'
  setglobal tags?
  echom 'Local tags (after):'
  setlocal tags?
  echom 'Omni Completion:' &l:omnifunc
endfunction " tag

nnoremap <Space> :Tags<CR>
command! -bang -nargs=? -complete=tag_listfiles Tags call s:tags ( <bang>0, <f-args> )
function s:tags ( bang, expression = expand ( '<cword>' ) ) abort
  let l:height = 5
  let l:winid = win_getid ()
  let l:file = expand ( '%:p' )

  if empty( a:expression ) | echo '' | return | endif
  if !!! ( a:expression =~ '^[a-zA-Z0-9_-]\+$' ) | echo '' | return | endif

  function! s:clear () closure
    echom 'Signature Bang:' a:bang
    echom 'Expression: "' .. a:expression .. '"'
    echom 'File:' l:file
    if !!! a:bang | return | endif
    call settagstack ( l:winid, { 'items': [] } )
  endfunction " s:clear
  call s:clear ()

  function! s:itemize ( list = [] ) closure
    let l:list = []

    echom 'itemize() List:'
    for item in a:list
      let l:target = fnamemodify( item['filename'], ':t' )
      call add(l:list, { 'module': item['name'] .. ' - '.. l:target,
        \ 'bufnr': bufnr(), 'lnum': item['line'], 'col': 'column', 'vcol': v:true,
        \ 'nr': 'errornr', 'pattern': item['cmd'], 'text': item['cmd'], 'type': item['kind'] } )
    endfor

    return l:list
  endfunction " s:itemize

  let l:stack = gettagstack ( l:winid )
  " TODO:if it starts with `/` then use fuzzy select
  let l:tags = [ {'bufnr': bufnr (), 'from': getcurpos (), 'tagname': a:expression } ]

  echom 'The Existing Items for "' .. a:expression .. '" '
        \ "#" stack[ 'curidx' ] 'of' stack [ 'length' ] ":\n"
  for  item in stack [ 'items' ]
    echom item
    echo
  endfor

  let l:stack[ 'items' ] = l:tags
  call settagstack ( l:winid, l:stack, 't' )

  echom "\n"
  echom join ( gettagstack ( l:winid )['items'], "\n\n" )

  if empty ( a:expression ) || &previewwindow | return | endif

  " Local Fix (lopen)  ====================================================
  " Call :lvim(grep) pattern <git root>
  let l:tags = taglist ( '^' .. a:expression, l:file )
  " Kinds:
  " a - array, c - class, C - constant, f - function,
  " m - method (usually with class), T - TODO, v - variable
  let l:list = filter ( l:tags, 'v:val["filename"] == "' .. l:file ..'"' )

  echom "Local list: "
  echom join ( l:list, "\n\n" )

  " Local QuickFix window
  call setloclist ( l:winid, s:itemize ( l:list ) )
  execute 'lopen' l:height
  let w:quickfix_title = '🏷️' .. a:expression

  let g:ctrlp_default_input = a:expression
  CtrlPTag

  return

  " Fix (copen) ===========================================================
  " execute 'lvimgrep' '/' .. l:expression .. '/j'  '%'
  " Call :vim(grep) pattern <git root>

  echom "\nGlobal tag list:"
  echom l:stack
  echom "\n"

  execute 'tags'

  " QuickFix window
  call setqflist ( l:stack [ 'items' ] )
  execute 'copen' l:height
  const w:quickfix_title = '🏷️' .. a:expression

  " Select from tags file
  execute 'tselect' a:expression

  " Preview window
  execute 'ptag!' a:expression

  " Jump back up to source file
  " execute 'win_gotoid' l:winid
  " execute ':buffer'  bufnr ()
  const l:winnr = l:winid .. 'wincmd' 'w'
  execute 'win_id2win' l:winnr

return

  const list = []
  for tag in l:tags
    call add( list, {
      \ 'pattern' : tag['cmd'],
      \ 'filename' : tag['filename'],
    \ })
  endfor

  if len ( list ) == 0 | echom '"' .. l:word .. '" Tag under cursor not found!' | endif
  if len ( list ) == 0 | return | endif
  echom 'The list:' string ( list )

" call setqflist( list )
" copen " QuickFix window

  execute 'tselect' l:word

  execute 'match CurSearch "\%' .. line ( '.' ) .. 'l\%' .. col ( '.' ) .. 'c\k*"'

  call search ( '$', 'b' ) " previous EOL
  const word = substitute ( l:word, '\\', '\\\\', '' )
  call search ( '\<\V'..l:word..'\>', 'cnz' ) " Match cursor & do not move (\V ery nomagic)

  " const stack = gettagstack(1003)
  " do something else
  " call settagstack(1003, stack)
endfunction " tags

function g:TagsStatus ( mods ) " abort
  let l:icon = ''

  if ( index ( a:mods, 'ctags' ) >= 0 )
    let l:icon ..= '🏷️'
  endif

  if (index ( a:mods, 'cscope' ) >= 0)
    let l:icon ..= '🔖'
  endif

  " echom strftime("%T") .. 'The icons: ' .. l:icon .. '& mods: ' .. join(a:mods, ',')

  return '[' .. l:icon .. ']'
endfunction  " TagsStatus

" -------------------------------------------------------------------------
" vim-TagList - https://github.com/yegappan/taglist
" -------------------------------------------------------------------------
autocmd VimDefaults VimEnter * call g:TagList()
" autocmd FileDefaults BufReadPost * call g:TagsList ()

function g:TagList () abort
  if &runtimepath !~ 'taglist' | return | endif

  let g:Tlist_Sort_Type = 'name'
  let g:Tlist_Use_SingleClick = 1
  let g:Tlist_Use_Right_Window = 1
  let g:Tlist_Enable_Fold_Column = 1
  " let g:Tlist_File_Fold_Auto_Close = 1
  let g:Tlist_Ctags_Cmd = split( system( 'type ctags' ) )[-1]

  echom 'Setting TagList binary tags path to: ' .. g:Tlist_Ctags_Cmd
endfunction " g:TagList

function g:TagsList () abort
  if ! exists('g:loaded_taglist') | return | endif

  echom 'Opening Tags List for ' .. expand('%')
  TlistOpen
  " .foldopen!
  wincmd p " Previous

endfunction " TagsList

" -------------------------------------------------------------------------
" TagBar - https://github.com/preservim/tagbar
" -------------------------------------------------------------------------
autocmd VimDefaults VimEnter * call g:TagBar()
autocmd FileDefaults BufReadPost * call g:TagsBar ()

function g:TagBar () abort
  if &runtimepath !~ 'tagbar' | return | endif

  " TagbarSetFoldlevel! 99

  let g:tagbar_foldlevel = 0
  let g:tagbar_autoshowtag = 1
" let g:tagbar_autopreview = 1
  let g:tagbar_show_prefix = 1
  let g:tagbar_show_suffix = 1
  let g:tagbar_singleclick = 1
  let g:tagbar_show_tag_count = 1
  let g:tagbar_show_data_type = 1
  let g:tagbar_help_visibility = 0
  let g:tagbar_show_tag_linenumbers = 1
  let g:tagbar_iconchars = ['👉', '👇']
  " let g:tagbar_position = 'leftabove vertical'
  let g:tagbar_position = 'rightbelow vertical'
  let g:tagbar_visibility_symbols
    \ = { 'public': '👀', 'protected' : '⚠️', 'private' : '🚫' }
  let g:tagbar_ctags_bin = split ( system ( 'type ctags' ) )[-1]
  " Max 20% or 25 characters
  let g:tagbar_width = max ( [ 25, winwidth (0) / 4 ] )
  echom 'Setting TagBar binary tags path to' .. g:tagbar_ctags_bin
endfunction " g:TagBar

function g:TagsBar () abort
  if &runtimepath !~ 'tagbar' | return | endif
  if len ( &buftype ) || index ( g:blacklist, &filetype ) >= 0 || empty ( &filetype ) | return | endif

  TagbarToggle
endfunction " TagsBar

" -------------------------------------------------------------------------
" Scopes :h cscope
"   - https://cscope.sourceforge.net
"   - https://en.wikipedia.org/wiki/Cscope
"   - https://fsl.cs.sunysb.edu/~rick/cscope.html
"   - https://stackoverflow.com/q/12243234/how-to-auto-load-cscope-out-in-vim
"   - https://stackoverflow.com/q/934233/cscope-or-ctags-why-choose-one-over-the-other
" -------------------------------------------------------------------------
set cscopequickfix=s-,c-,d-,i-,t-,e-,a-
autocmd FileType ruby,python,javascript :Scope

command! -bang -nargs=? -complete=cscope Scope call s:scope ( <bang>0, <q-args> )
function s:scope () abort
  const l:bang = get ( a:, 1, v:false )
  const l:command = 'cscope'
  " TODO: Follow tagcase
  const l:suffix = &g:ignorecase ? '-C' : '' " Case sensitifity flag

  " executable('scope')
  call system ( 'command -v ' .. l:command )
  if v:shell_error | return | else | echom l:command 'Scoping...' | endif

  set cscopeverbose " Database addition messages
  set cscopepathcomp =2 " Path parts of db path
  set cscopetagorder =0 "Search CScope database first

  echom 'Current Dir:' getcwd ()
  for extension in [ 'js', 'py', 'rb' ] " Javascript, Python, Ruby
    const l:out = findfile ( 'cscope.' .. extension .. '.out', '.;' )

    if !!! filereadable ( l:out )  | continue | endif

    echom '(scope) definitions path:' l:out

    " -v -b -q -U -f cscope.js.out -R $( cat $files )
    " cscope add '' .. l:out
    silent! execute 'cscope add' l:out l:suffix
    " TODO: Reconnect If mtime > last connection time
    " https://github.com/ktchen14/cscope-auto/blob/master/autoload/cscope_auto.vim#L90
    " :h getftime('file_location')
    cscope reset
    echom "\n"
    cscope show
    echom ''
  endfor " extension
endfunction " scope

" -------------------------------------------------------------------------
" CtrlP - https://github.com/ctrlpvim/ctrlp.vim
"  - https://github.com/tacahiroy/ctrlp-funky
"  - https://github.com/ivalkeen/vim-ctrlp-tjump
" -------------------------------------------------------------------------
autocmd VimDefaults VimEnter * :Fuzzy

command! Fuzzy call s:fuzzy ()
function! s:fuzzy () abort
  if &runtimepath !~ 'ctrlp.vim' | return | endif

  echom 'Mapping CtrlP Mixed Mode to f<Enter>'
  let g:ctrlp_map = 'f<Enter>'
  let g:ctrlp_cmd = 'CtrlPMixed'
  let g:ctrlp_extensions = ['mixed']
  nnoremap f<Enter> :CtrlPMixed<CR>

  let g:ctrlp_regexp = 1 " <C-r>
  let g:ctrlp_show_hidden = 1
  let g:ctrlp_by_filename = 1 " <C-d>
  let g:ctrlp_match_window = 'bottom,order:btt,min:3,max:10,results:10'
  let g:ctrlp_root_markers
    \ = ['.git', 'node_modules', 'package.json', 'Gemfile', '.bashrc' ]

  let g:buftag_ctags_bin = split( system( 'type ctags' ) )[-1]
  echom 'Setting CtrlP binary tags path to:' g:buftag_ctags_bin

  let g:ctrlp_extensions += [ 'tag', 'buffertag' ]

  let g:ctrlp_buftag_types = {
    \ 'erlang' :
      \ '--language-force=erlang --erlang-types=drmf',
    \ 'javascript' : {
      \ 'bin': 'jsctags',
      \ 'args': '-f - ',
    \ }
  \ }

  echom 'CtrlP tag types:' string( g:ctrlp_buftag_types )
  echom 'CtrlP tag extensions:' string( g:ctrlp_extensions )

  if &runtimepath !~ 'vim-ctrlp-tjump'
    echom 'CtrlP Mapping <C-]> (tjump) tag'
    nnoremap <C-]> :CtrlPtjump<CR>
    vnoremap <C-]> :CtrlPtjumpVisual<CR>
  endif

  if &runtimepath !~ 'vim-ctrlp-funky'
    let g:ctrlp_funky_syntax_highlight = 1
  endif
endfunction " fuzzy

" -------------------------------------------------------------------------
" Supertab - https://github.com/ervandew/supertab
" -------------------------------------------------------------------------
autocmd VimDefaults VimEnter * call g:Tab ()

function g:Tab () abort
  if &runtimepath !~ 'supertab' | return | endif

  " echom 'Mapping SuperTab insert mode to <Tab> & <S-Tab>'
  " inoremap <Tab> <c-o>:echom 'SuperTAB Complete'<CR>
  " inoremap <S-Tab> <c-o>:echom 'SHIFT + SuperTAB Complete'<CR>

" let g:SuperTabDefaultCompletionType = 'context'
  " " fallback to SuperTabContextDefaultCompletionType = <C-p>
  " call SuperTabSetDefaultCompletionType( g:SuperTabDefaultCompletionType )
  " echom 'SuperTab default completion type (completefunc|omnifunc): '
  "   \ .. g:SuperTabDefaultCompletionType
  " echom 'SuperTab secondary completion type:'
  " ' \ ..g:SuperTabContextDefaultCompletionType
endfunction " Tab

" -------------------------------------------------------------------------
" Mμ Complete - https://github.com/lifepillar/vim-mucomplete
" -------------------------------------------------------------------------
autocmd VimDefaults VimEnter * :MuComplete

function! g:MuComplete () abort
  if &runtimepath !~ 'vim-mucomplete' | return | endif

  " set complete-=t " no tags
  set complete-=i " no includes

  let chain = [ 'omni','path','c-n', 'uspl' ]
  let default = [ 'list', 'omni', 'cmd', 'file', 'path', 'c-n', 'dict', 'keyn', 'keyp', 'uspl' ]

  let g:mucomplete#completion_delay = 1
  let g:mucomplete#enable_auto_at_startup = 1
  let g:mucomplete#wordlist = { '' : [ 'devpunks', 'snuggsi' ] } " list

  let g:mucomplete#chains = {}
  let g:mucomplete#chains['html'] = chain
  let g:mucomplete#chains['css'] = g:mucomplete#chains['html']
  let g:mucomplete#chains['default'] = { 'default' : default }
endfunction " search

" -------------------------------------------------------------------------
" Ultisnips - https://github.com/SirVer/ultisnips
" -------------------------------------------------------------------------
autocmd VimDefaults VimEnter * call g:Snippets ()

function g:Snippets () abort
  if &runtimepath !~ 'ultisnips' | return | endif

  echom 'Ultisnippets Initialization'

  " let g:UltiSnipsEditSplit = 'vertical'
  let g:UltiSnipsAutoTrigger = 0
  let g:UltiSnipsNoPythonWarning = 1
  let g:UltiSnipsListSnippets = '<S-Tab>'
  let g:UltiSnipsExpandTrigger = '<S-Tab>'
  let g:UltiSnipsJumpForwardTrigger = '<c-n>'
  let g:UltiSnipsJumpBackwardTrigger = '<c-p>'
  let g:UltiSnipsJumpOrExpandTrigger = '<S-Tab>'
endfunction " Snippets

" -------------------------------------------------------------------------
" ZoomWin
" -------------------------------------------------------------------------
" nnoremap <Enter> :call g:ZoomDrawer()<CR>

function! g:ZoomDrawer () abort
  if !!! exists ( '*ZoomWin' ) | return | endif

  let l:open = g:NERDTree.IsOpen ()
  " TODO: Use tagbar#IsOpen ()
  NERDTreeClose
  TagbarClose
  TlistClose
  ZoomWin
  " Open Drawer & focus on `p`revious buffer
  if l:open | NERDTree | wincmd p | endif
  " const l:tagbar_open = bufwinnr( t:tagbar_buf_name) != -1
  "  if ( l:tagbar_open ) | TagbarOpen | wincmd p | endif
endfunction " ZoomDrawer

" -------------------------------------------------------------------------
" NETRW
" - :help netrw
" - :help netrw-browse-maps
" -------------------------------------------------------------------------
let g:loaded_netrw = 1         " open splits to the right
let g:loaded_netrwPlugin = 1         " open splits to the right
let g:netrw_altv = 1         " open splits to the right
let g:netrw_banner = 0       " disable banner let g:netrw_browse_split=4 " open prior window
let g:netrw_liststyle =  3    " treeview
"let g:netrw_list_hide=netrw_gitignore#Hide()

" -------------------------------------------------------------------------
" NERDTree - https://github.com/preservim/nerdtree
"   - Shortcuts - https://github.com/preservim/nerdtree/blob/master/doc/NERDTree.txt#L247-L293
" -------------------------------------------------------------------------
autocmd VimDefaults VimEnter * call g:NerdInit ()
autocmd FileDefaults BufReadPost * call g:NerdDrawer ()

function! g:NerdInit () abort
  if !!! exists ( 'g:NERDTree' ) | return | endif

  " nerdtree-git-plugin
  let g:NERDTreeGitStatusIndicatorMapCustom = {
        \ 'Untracked' : '🫣',
        \ 'Dirty' : '⚠️',
        \ 'Renamed' : '📑',
        \ 'Deleted' : '❌',
        \ 'Ignored' : '🚫',
        \ 'Unknown' : '❓',
        \ 'Modified' : '📝',
  \ }

  let g:NERDTreeWinPos='left'
  let g:NERDTreeStatusline='TODO: GitDiffs()'
  let g:NERDTreeIgnore=[ '\.sock$', 'my-pipe$' ] " ignored files
  let g:NERDTreeFileLines=1 " LOC number in files
  let g:NERDTreeShowHidden=1 " Show hidden files (I)
  let g:NERDTreeShowBookmarks=1 " Show Bookmarks (B)
  let g:NERDTreeBookmarksFile='.NERDmarks' " location
  let g:NERDTreeHighlightCursorLine=1 " highlight current line
  let g:NERDTreeDirArrowExpandable  = '📁' " Expandable directory
  let g:NERDTreeDirArrowCollapsible = '📂' " Collapsible directory
  let g:NERDTreeGitStatusConcealBrackets = 0 " 0 - show | 1 = hide
endfunction " NerdInit

function! g:NerdDrawer () abort
  if !!! exists ( 'g:NERDTree' ) | return | endif
  if len ( &buftype ) || index ( g:blacklist, &filetype ) >= 0 || empty ( &filetype ) | return | endif

  NERDTreeFind " Open Drawer & Find current
  if expand ( '%:t' ) =~ 'NERD_tree_tab' | wincmd p  |  endif
  wincmd p " Focus on `p`revious buffer
endfunction " NerdDrawer

function g:NerdToggle () abort
  if exists ( ':TagbarToggle' )
    TagbarToggle
    TagbarTogglePause
  endif

    NERDTreeToggle
    if ! g:NERDTree.IsOpen() | return | endif

    echom g:NERDTree.IsOpen ()
    NERDTreeFind " Open Drawer & Find current
    if expand ( '%:t' ) =~ 'Tagbar' | wincmd h | endif
    if expand ( '%:t' ) =~ 'NERD_tree_tab' | wincmd l | endif

  " :TlistToggle
endfunction " NerdToggle

nnoremap <Tab><Enter> :call g:NerdToggle ()<CR>

" -------------------------------------------------------------------------
" Fern - https://github.com/lambdalisue/vim-fern
" -------------------------------------------------------------------------
autocmd VimDefaults VimEnter * call g:Fern()
" autocmd FileDefaults FileType fern call g:FernDrawer()

function! g:Fern () abort
  if &runtimepath !~ 'vim-fern' | return | endif

  " [SHIFT]+[TAB] Opens Fern
" nnoremap <S-Tab> :Fern -drawer -stay .

  let g:fern#mark_symbol = '📌'
  let g:fern#renderer#default#leading = '|'
  let g:fern#renderer#default#root_symbol = '🎯'
  let g:fern#renderer#default#leaf_symbol = '📄'
  let g:fern#renderer#default#expanded_symbol = '📂'
  let g:fern#renderer#default#collapsed_symbol = '📁'

  Fern -drawer -stay .
endfunction " Fern

function! g:FernDrawer () abort
  echom 'Fern Drawer'
  setlocal nonumber
  setlocal splitright

  nnoremap <buffer> <Esc> :bw
  " Custom <Plug>in command
  nnoremap <Plug>(fern-close-drawer) :<C-u>FernDo close -drawer -stay<CR>

  nnoremap <buffer> q :FernDo close -drawer -stay

  " Jump to top directory
  nnoremap <buffer> P gg
  nnoremap <buffer> I <Plug>(fern-action-hidden-toggle)

  noremap <buffer> <C-l> <C-w>l
  noremap <buffer> <C-h> <C-w>h

  " mappings
  nnoremap <buffer> x <Plug>(fern-action-collapse)
  " nnoremap <buffer> o <Plug>(fern-action-open:edit)
  nnoremap <buffer> o <Plug>(fern-action-open:right)
  nnoremap <buffer> go <Plug>(fern-action-open:edit)<C-w>p
  nnoremap <buffer> t <Plug>(fern-action-open:tabedit)
  nnoremap <buffer> T <Plug>(fern-action-open:tabedit)gT
  nnoremap <buffer> i <Plug>(fern-action-open:split)
  nnoremap <buffer> gi <Plug>(fern-action-open:split) | wincmd p
  nnoremap <buffer> s <Plug>(fern-action-open:vsplit)
  nnoremap <buffer> si <Plug>(fern-action-open:vsplit)<C-w>p

  nnoremap <buffer> ma <Plug>(fern-action-new-path)
  nnoremap <buffer> C <Plug>(fern-action-enter)
  nnoremap <buffer> u <Plug>(fern-action-leave)
  nnoremap <buffer> r <Plug>(fern-action-reload)
  nnoremap <buffer> R gg<Plug>(fern-action-reload)
  nnoremap <buffer> cd <Plug>(fern-action-cd)
  nnoremap <buffer> CD gg<Plug>(fern-action-cd)<C-o>
endfunction " FernDrawer

" -------------------------------------------------------------------------
" Closetag - https://github.com/alvan/vim-closetag
" -------------------------------------------------------------------------
autocmd VimDefaults VimEnter * call s:CloseTags()

function! s:CloseTags () abort
  if ! exists('g:loaded_closetag') | return | endif

  " These are the file types where this plugin is enabled.
  let g:closetag_filetypes = 'svg,html,eruby,*.vue'

  " These are the file extensions where this plugin is enabled.
  let g:closetag_filenames = '*.svg,*.html,*.html.erb,*.vue'

  " This will make the list of non-closing tags self-closing in the specified files.
  "let g:closetag_xhtml_filetypes = 'xhtml,jsx'

  " This will make the list of non-closing tags self-closing in the specified files.
  let g:closetag_xhtml_filenames = '*.vue,*.jsx'

  " This will make the list of non-closing tags case-sensitive (e.g. `<Link>` will be closed while `<link>` won't.)
  "let g:closetag_emptyTags_caseSensitive = 1
endfunction " CloseTags

" -------------------------------------------------------------------------
" Asyncomplete Emoji - https://github.com/prabirshrestha/asyncomplete-emoji.vim
" -------------------------------------------------------------------------
" autocmd VimDefaults asyncomplete_setup * call g:AsyncompleteEmoji()
autocmd VimDefaults VimEnter * call g:AsyncompleteEmoji()

function g:AsyncompleteEmoji () abort
  if &runtimepath !~ 'asyncomplete-emoji' | return | endif

  echom 'Loading asyncomplete-emoji'

  call asyncomplete#register_source ( asyncomplete#sources#emoji#get_source_options ({
    \ 'name': 'emoji',
    \ 'allowlist': ['*'],
    \ 'completor': function('asyncomplete#sources#emoji#completor'),
    \ }))
endfunction " AsyncompleteEmoji

" -------------------------------------------------------------------------
" Asyncomplete Buffer - https://github.com/prabirshrestha/asyncomplete-buffer.vim
" -------------------------------------------------------------------------
autocmd VimDefaults VimEnter * call g:AsyncompleteBuffer ()

function g:AsyncompleteBuffer () abort
  if &runtimepath !~ 'asyncomplete-buffer' | return | endif

  echom 'Loading asyncomplete-buffer'

  call asyncomplete#register_source(asyncomplete#sources#buffer#get_source_options({
    \ 'name': 'buffer',
    \ 'blocklist': [],
    \ 'allowlist': ['*'],
    \ 'config': { 'max_buffer_size': -1, },
    \ 'completor': function ( 'asyncomplete#sources#buffer#completor' ),
    \ }))
endfunction " AsyncompleteBuffer

" -------------------------------------------------------------------------
" Asyncomplete File - https://github.com/prabirshrestha/asyncomplete-file.vim
" -------------------------------------------------------------------------
autocmd VimDefaults VimEnter * call g:AsyncompleteFile()
" autocmd User asyncomplete_setup * call g:AsyncompleteFile()

function g:AsyncompleteFile () abort
  if &runtimepath !~ 'asyncomplete-file' | return | endif

  echom 'Loading asyncomplete-file'

  call asyncomplete#register_source(asyncomplete#sources#file#get_source_options({
    \ 'name': 'file',
    \ 'priority': 10,
    \ 'allowlist': ['*'],
    \ 'completor': function('asyncomplete#sources#file#completor'),
    \ }))
endfunction " AsyncompleteFile

" -------------------------------------------------------------------------
" Asyncomplete Tags - https://github.com/prabirshrestha/asyncomplete-tags.vim
" -------------------------------------------------------------------------
autocmd VimDefaults VimEnter * call g:AsyncompleteTags ()

function g:AsyncompleteTags () abort
  if &runtimepath !~ 'asyncomplete-tags' | return | endif

  echom 'Loading asyncomplete-tags'

  call asyncomplete#register_source ( asyncomplete#sources#tags#get_source_options ({
    \ 'name': 'tags',
    \ 'allowlist': ['*'],
    \ 'config': { 'max_file_size': -1, },
    \ 'completor': function('asyncomplete#sources#tags#completor'),
    \ }))
endfunction " AsyncompleteTags

" -------------------------------------------------------------------------
" Asyncomplete Ultisnips - https://github.com/prabirshrestha/asyncomplete-ultisnips.vim
" -------------------------------------------------------------------------
autocmd VimDefaults VimEnter * call g:AsyncompleteUltisnips ()

function g:AsyncompleteUltisnips () abort
  if &runtimepath !~ 'asyncomplete-ultisnips' | return | endif

  echom 'Loading asyncomplete-ultisnips'

  call asyncomplete#register_source ( asyncomplete#sources#ultisnips#get_source_options ({
    \ 'name': 'ultisnips',
    \ 'allowlist': ['*'],
    \ 'completor': function ( 'asyncomplete#sources#ultisnips#completor' ),
    \ }))
endfunction " AsyncompleteUltisnips

" -------------------------------------------------------------------------
" Vim LSP - https://github.com/prabirshrestha/vim-lsp
" -------------------------------------------------------------------------
autocmd VimDefaults VimEnter * call g:LSP ()
augroup UserDefaults
  autocmd User lsp_float_opened nmap <buffer><silent>
    \ <C-c> <Plug>(lsp-preview-closed)
  autocmd User lsp_float_closed nunmap <buffer> <C-c>
  autocmd User lsp_buffer_enabled call s:on_lsp_buffer_enabled ()
augroup END
autocmd FileDefaults BufReadPost * echom 'Loading vim-lsp-server for' expand ( '%' )

function g:LSP () abort
  if &runtimepath !~ 'vim-lsp' | return | endif

  echom 'VIM LSP'
  call lsp#enable ()

  let g:lsp_preview_float = 1
  let g:lsp_use_native_client = 1
  let g:lsp_preview_autoclose = 1

  let g:lsp_signature_help_delay = 100
  let g:lsp_tree_incoming_prefix = '⬅'
  let g:lsp_diagnostics_signs_delay = 100
  let g:lsp_diagnostics_signs_priority = 11 " 10 other plugins
  let g:lsp_diagnostics_virtual_text_delay = 300
  let g:lsp_diagnostics_virtual_text_align = 'right'
  let g:lsp_diagnostics_signs_hint = {'text': '💡' }
  let g:lsp_diagnostics_signs_error = {'text': '❌' }
  let g:lsp_diagnostics_signs_warning = {'text': '⚠️' }
  let g:lsp_diagnostics_signs_information = {'text': 'ℹ️' }
  let g:lsp_document_code_action_signs_delay = 300
  let g:lsp_document_code_action_signs_hint = {'text': '🚀' }

  " if executable('bash-language-server')
    autocmd User lsp_setup call lsp#register_server ({
    \ 'allowlist': ['sh', 'bash'],
    \ 'name': 'bash-language-server',
    \ 'cmd': {server_info->['bash-language-server', 'start']},
    \ })
  " endif

  " https://github.com/rhysd/vim-healthcheck
  CheckHealth

  LspStatus
  LspStopServer
  call lsp#disable () " TODO: REMOVE"

endfunction " LSP

function! s:on_lsp_buffer_enabled () abort
  echom 'LSP Buffer Enabled'
  if exists ( '+tagfunc' ) | setlocal tagfunc=lsp#tag#tagfunc | endif

  setlocal omnifunc=lsp#complete

  let g:lsp_diagnostics_enabled = 1 " in lieu of ALE
  let g:lsp_format_sync_timeout = 1000

  nmap <buffer> K  <Plug>(lsp-hover)
  nmap <buffer> gd <Plug>(lsp-definition)
  nmap <buffer> gr <Plug>(lsp-references)
  nmap <buffer> gi <Plug>(lsp-implementation)
  nmap <buffer> gt <Plug>(lsp-type-definition)
  nmap <buffer> gs <Plug>(lsp-document-symbol-search)
  nmap <buffer> gS <Plug>(lsp-workspace-symbol-search)
  nmap <buffer> <leader>rn <Plug>(lsp-rename)
  nnoremap <buffer> <expr><C-d> lsp#scroll(-4)
  nnoremap <buffer> <expr><C-f> lsp#scroll(+4)
  nmap <buffer> g] <Plug>(lsp-next-diagnostic)
  nmap <buffer> [g <Plug>(lsp-previous-diagnostic)

endfunction " on_lsp_buffer_enabled

" -------------------------------------------------------------------------
" Vim LSP Settings - https://github.com/mattn/vim-lsp-settings
" -------------------------------------------------------------------------
autocmd VimDefaults VimEnter * call g:LSPSettings ()

function g:LSPSettings () abort
  if &runtimepath !~ 'vim-lsp-settings' | return | endif

  echom 'VIM LSP Settings'

  let g:lsp_settings_servers_dir  = expand ( '$HOME/.vim/servers' )
  let g:lsp_settings_root_markers = [
    \ '.git',
    \ 'Gemfile',
    \ 'package.json',
    \ 'node_modules/',
  \]
endfunction " LSPSettings

" -------------------------------------------------------------------------
" CoC.vim - https://github.com/neoclide/coc.nvim
" -------------------------------------------------------------------------

" -------------------------------------------------------------------------
" Ale - https://github.com/dense-analysis/ale
" -------------------------------------------------------------------------
autocmd VimDefaults VimEnter * call g:Lint ()
augroup UserDefaults
  autocmd User AleFixPre echom 'ALE - Disable Syntax'
  autocmd User AleFixPost echom 'ALE - Enable Syntax'
augroup END

function g:Lint () abort
  if &runtimepath !~ 'ale' | return | endif

  echom 'Setting up Ale'

  let g:ale_linters = {
  \ 'sh': [ 'language_server' ],
  \ }
  let g:ale_fixers = {
    \ 'json': ['jq'],
    \ 'ruby': ['rubocop'],
    \ 'python': ['flake8'],
    \ '*': [ 'remove_trailing_lines', 'trim_whitespace' ],
  }

endfunction " Lint

" -------------------------------------------------------------------------
" Vim-test - https://github.com/vim-test/vim-test
" -------------------------------------------------------------------------
autocmd VimDefaults VimEnter * call g:TestSetup()

function g:TestSetup () abort
  if &runtimepath !~ 'vim-test' | return | endif

  echom 'Vim Testing Setup'

  let test#strategy = 'dispatch'
  let test#strategy = {
  \ 'file': 'basic',
  \ 'class': 'basic',
  \ 'last': 'basic',
  \ 'visit': 'basic',
  \ 'nearest': 'basic',
  \ 'suite': 'dispatch',
  \ }
  let test#runner_commands = [
  \ 'Bats', 'ShellSpec',
  \ 'NodeTest', 'WebdriverIO',
  \ 'Rails', 'RSpec', 'Minitest'
  \ ]

  let g:test#ruby#minitest#options
    \ = { 'all' : '--verbose' }
  let g:test#ruby#rspec#options =  {}

  nnoremap <Leader>t :TestNearest<CR>
  nnoremap <Leader>T :TestFile<CR>
  nnoremap <Leader>a :TestSuite<CR>
  nnoremap <Leader>c :TestClass<CR>
  nnoremap <Leader>l :TestLast<CR>
  nnoremap <Leader>g :TestVisit<CR>

endfunction " TestSetup


" -------------------------------------------------------------------------
" Vim-javascript - https://github.com/pangloss/vim-javascript
" -------------------------------------------------------------------------
autocmd VimDefaults VimEnter * call g:VimJavascript ()

function g:VimJavascript () abort
  if &runtimepath !~ 'vim-javascript' | return | endif

  echom 'Vim Javascript Setup'

  let g:javascript_conceal_function             = 'ƒ'
  let g:javascript_conceal_null                 = 'ø'
  let g:javascript_conceal_this                 = '@'
  let g:javascript_conceal_return               = '⇚'
  let g:javascript_conceal_undefined            = '¿'
  let g:javascript_conceal_NaN                  = 'ℕ'
  let g:javascript_conceal_prototype            = '¶'
  let g:javascript_conceal_static               = '•'
  let g:javascript_conceal_super                = 'Ω'
  let g:javascript_conceal_arrow_function       = '⮕'
  let g:javascript_conceal_noarg_arrow_function = '⇒'
  let g:javascript_conceal_underscore_arrow_function = '⇨'
endfunction

" -------------------------------------------------------------------------
" Vim-ruby - https://github.com/vim-ruby/vim-ruby
" -------------------------------------------------------------------------
autocmd VimDefaults VimEnter * call g:VimRuby ()

function g:VimRuby () abort
  if &runtimepath !~ 'vim-ruby' | return | endif

  echom 'Vim Ruby Setup'

  " Ruby Indent
  let g:ruby_indent_block_style = 'do'
  let g:ruby_indent_hanging_elements = 0
  let g:ruby_indent_assignment_style = 'variable'
  let g:ruby_indent_access_modifier_style = 'outdent'

  " Ruby Syntax
  let ruby_operators = 1
  let ruby_space_errors = 1
  let ruby_pseudo_operators = 1
  let  ruby_line_continuation_error = 1

  " Ruby Omni-completion  <C-x><C-o>
  let g:rubycomplete_rails = 1
  let g:rubycomplete_load_gemfile = 1
  let g:rubycomplete_buffer_loading = 1
  let g:rubycomplete_classes_in_global = 1

endfunction " g:VimRuby

" }}}

" =========================================================================
" {{{ TYPOGRAPHY.VIMRC
" =========================================================================
if $TERM =~ '256color'
  " WARNING: ^[ must be entered as <c-v><c-[>
  echom '$TERM is set to 256color'
  let &t_so = '' " smso (standout)
  let &t_ZH = '' " sitm (enable italics)
  let &t_ZR = '' " ritm (disable italics)
endif

syntax on " turns syntax highlighting on

" Spelling ----------------------------------------------------------------
set spelloptions = "camel"
set spellsuggest = "fast"
set spell " Enable spellchecking - https://vimtricks.com/p/vim-spell-check

" Line Continuation -------------------------------------------------------
" (NORMAL/VISUAL MODE)
set whichwrap=h,l " 'h' & 'l' wrap EOL & BOL
set whichwrap+=b,s " (b)ackspace & (s)pace wrap EOL & BOL
" (NORMAL/VISUAL MODE)
set whichwrap+=<,> " < left and right > arrow wrap to prev. and next line
" (INSERT/REPLACE MODE)
set whichwrap+=[,] " [ left and right ] arrow wrap to prev. and next line
set backspace=indent,eol,nostop " Insert mode <BS> deletion

" Line Length -------------------------------------------------------------
set wrap " word
set linebreak " Avoid mid-word line wrapping
set showbreak=⥹ " Character used for wrapped line
set textwidth=75 " wrap https://vimtricks.com/p/vim-line-length-marker
set wrapmargin=0 " Newline insert based on terminal width (0 = disabled)
set synmaxcol=256 " Prevent slow loading https://github.com/tpope/vim-sensible/issues/142

" Whitespace --------------------------------------------------------------
const s:TABSIZE=2
set expandtab "turn tabs into (tabstop) spaces
set shiftround " Rounds the indent spacing to the next multiple of shiftwidth
let &tabstop=s:TABSIZE "set tab character to 2 characters
let &shiftwidth=s:TABSIZE " Shift-indent size - http://vimcasts.org/episodes/tabs-and-spaces
let &softtabstop=s:TABSIZE " https://vi.stackexchange.com/q/4244

retab! " (Force!) update tab format

set list " show hidden characters & replacement characters
set listchars=tab:▣□▢,extends:⇨,precedes:⇦,leadmultispace:\|\ \|\ ,multispace:\.,lead:·,space:╵,nbsp:■,trail:■,eol:↴

set sidescroll=10 " scroll amount when a word is outside of view
" https://vim.fandom.com/wiki/Keep_your_cursor_centered_vertically_on_the_screen
set scrolloff=999 " Line jump scrolling offset (999=centered)
set display=lastline " Show Special chars for long last line

"}}}

" =========================================================================
" {{{ COLORSCHEME
"  - ./vim/colors/default.vim
"  - ./vim/colors/devpunks.vim
"  * can use hexidecimal values for gui (e.g. guibg=#000000)
"  * term modes (NONE,(s)tandout,(r)everse,(i)talic,(b)old, (u)nderline, under(c)url)
"
"  - https://jonasjacek.github.io/colors
"  - http://vim.wikia.com/wiki/Xterm256_color_names_for_console_Vim
"  - http://bjornenki.com/blog/gvim-colorscheme/bjornenki-colorscheme.vim
"  - Overrides - https://gist.github.com/romainl/379904f91fa40533175dfaec4c833f2f
"  - https://vi.stackexchange.com/q/8751/how-to-completely-turn-off-colorscheme
"hi Example guifg=NONE guibg=#ff0000 gui=NONE ctermfg=NONE ctermbg=NONE cterm=NONE
" =========================================================================
set t_ut= " terminal background
set t_Co=256 " enable 256 colors
set background=dark " [dark|light]
set termguicolors " 24bit gui(fg|bg)

autocmd VimDefaults ColorScheme *
\ try | colorscheme devpunks
\   catch | colorscheme default
\ endtry

" :help xterm-true-color
" TODO: determine xterm-true-color escapes
" https://groups.google.com/g/vim_dev/c/wsC205JQpDo
"let &t_8f = '[38:2:%lu:%lu:%lum'
"let &t_8b = '[48:2:%lu:%lu:%lum'

" Interactive Status -----------------------------
echom 'Setting StatusLine Color'
augroup Status
  autocmd InsertLeave * highlight! StatusLineNC term=NONE,bold cterm=NONE,bold gui=NONE,bold
  autocmd InsertLeave * highlight! StatusLine term=reverse,bold cterm=reverse,bold gui=reverse,bold
  autocmd InsertEnter * highlight! StatusLineNC term=NONE,bold cterm=NONE,bold gui=NONE,bold
  autocmd InsertEnter * highlight! StatusLine term=bold,italic,reverse cterm=bold,italic,reverse gui=bold,italic,reverse
augroup END

" }}}

" =========================================================================
" {{{ CONCEAL.VIM
" =========================================================================
set conceallevel=2

syntax match Conceal 'U+' conceal cchar=⊎
syntax match Conceal '*' conceal cchar=✖
syntax match Conceal ';' conceal cchar=；
syntax match Conceal '=' conceal cchar=⚌
" syntax match Conceal '!' conceal cchar=¬
syntax match Conceal '!' conceal cchar=❗
syntax match Conceal '(' conceal cchar=（
syntax match Conceal ')' conceal cchar=）
syntax match Conceal '\]' conceal cchar=］ "〛
syntax match Conceal '\[' conceal cchar=［ "〚
syntax match Conceal '{' conceal cchar=⦃
syntax match Conceal '}' conceal cchar=⦄
syntax match Conceal ':' conceal cchar=：

syntax match Conceal '%' conceal cchar=％
syntax match Conceal '&' conceal cchar=＆
syntax match Conceal '?' conceal cchar=❔
syntax match Conceal '??' conceal cchar=❓
syntax match Conceal '->' conceal cchar=➔
syntax match Conceal '\.\.\.' conceal cchar=⋯

syntax match Conceal '+=' conceal cchar=⩲
syntax match Conceal '*=' conceal cchar=⩧
syntax match Conceal '++' conceal cchar=➕
syntax match Conceal '--' conceal cchar=➖
syntax match Conceal '==' conceal cchar=⩵
syntax match Conceal '!=' conceal cchar=≠
syntax match Conceal '===' conceal cchar=⩶
syntax match Conceal '!==' conceal cchar=≢
syntax match Conceal '<=' conceal cchar=≤
syntax match Conceal '=>' conceal cchar=≥
syntax match Conceal '=\~' conceal cchar=≈
syntax match Conceal '!\~' conceal cchar=≉
syntax match Conceal '=\~#' conceal cchar=≋
syntax match Conceal '>>' conceal cchar=⨠
syntax match Conceal '<<' conceal cchar=≪
syntax match Conceal '&&' conceal cchar=∧
syntax match Conceal '||' conceal cchar=∨
syntax match Conceal '((' conceal cchar=⦅
syntax match Conceal '))' conceal cchar=⦆
syntax match Conceal '\[\[' conceal cchar=〚
syntax match Conceal '\]\]' conceal cchar=〛

syntax match Conceal '\<v\:null\>' conceal cchar=ω
syntax match Conceal '\<undefined\>' conceal cchar=ω
syntax match Conceal '\<\(null\|nil\)\>' conceal cchar=ω
syntax match Conceal '\<true\>' conceal cchar=⊤
syntax match Conceal '\<false\>' conceal cchar=⊥
syntax match Conceal '\<assert\>' conceal cchar=‼

syntax match Conceal '\<BEGIN\>' conceal cchar=︷
syntax match Conceal '\<END\>' conceal cchar=︸
syntax match Conceal '\<fn\>' conceal cchar=𝑓
syntax match Conceal '\<def\(ine\)\?\>' conceal cchar=𝑓
syntax match Conceal '\<[fF]unction\>' conceal cchar=𝑓
syntax match Conceal '\<end\(function\)\?\>' conceal cchar=Ⅎ

syntax match Conceal '\<bool\>' conceal cchar=𝔹
syntax match Conceal '\<char\>' conceal cchar=∁
syntax match Conceal '\<string\>' conceal cchar=𝐒
syntax match Conceal '\<unsigned\>' conceal cchar=ℕ
syntax match Conceal '\<int\(eger\)\?\>' conceal cchar=ℤ
syntax match Conceal '\<vector\>' conceal cchar=V
syntax match Conceal '\<tensor\>' conceal cchar=𝕋

syntax match Conceal '\<for\(each\)\?\>' conceal cchar=∀
syntax match Conceal '\<for \zsof\ze' conceal cchar=⊂
syntax match Conceal '\<do\>' conceal cchar=🔁
syntax match Conceal '\<loop\>' conceal cchar=🔄
syntax match Conceal '\<while\>' conceal cchar=🔂
syntax match Conceal '\<break\>' conceal cchar=↪
syntax match Conceal '\<return\>' conceal cchar=↩
syntax match Conceal '\<continue\>' conceal cchar=🔃
syntax match Conceal '\<next\>' conceal cchar=🔃

syntax match Conceal '\<match\>' conceal cchar=～
syntax match Conceal '\<if\>' conceal cchar=⮕
" https://en.wikipedia.org/wiki/Therefore_sign
syntax match Conceal '\<then\>' conceal cchar=⇒
syntax match Conceal '\<else\>' conceal cchar=⇶
syntax match Conceal '\<el\(se\)\?if\>' conceal cchar=⇉
syntax match Conceal '\<else if\>' conceal cchar=⇉
syntax match Conceal '\<endif\>' conceal cchar=⇦

syntax match Conceal '\<class\>' conceal cchar=§
syntax match Conceal '\<module\>' conceal cchar=📦
syntax match Conceal '\<enum\>' conceal cchar=∐
syntax match Conceal '\<struct\>' conceal cchar=∏
syntax match Conceal '\<unsafe\>' conceal cchar=☡
syntax match Conceal '\<public\>' conceal cchar=👀
syntax match Conceal '\<private\>' conceal cchar=🕶
syntax match Conceal '\<protected\>' conceal cchar=👓

syntax match Conceal "select \zs\*\ze" conceal cchar=✱
syntax match Conceal '\<from\>' conceal cchar=⫁
syntax match Conceal '\<\cwhere\>' conceal cchar=Θ
syntax match Conceal '\<in\>' conceal cchar=∈
syntax match Conceal '\<not in\>' conceal cchar=∉
syntax match Conceal '\<\cunion\>' conceal cchar=⨄
syntax match Conceal '\<\cjoin\(s\)\?\>' conceal cchar=⨝
syntax match Conceal /\cleft outer join/ conceal cchar=⟕
syntax match Conceal /\cright outer join/ conceal cchar=⟖
syntax match Conceal '\<\cexist\(s\)\?\>' conceal cchar=∃

syntax match Conceal '1\.618[0-9]*' conceal cchar=Φ
syntax match Conceal '2\.718[0-9]*' conceal cchar=e

syntax match Conceal '\<\%([mM]ath\.\)\?[pP]i\>' conceal cchar=π
syntax match Conceal '\<\%([mM]ath\.\)\?[pP]ow\>' conceal cchar=⌃
syntax match Conceal '\<\%([mM]ath\.\)\?[sS]in\>' conceal cchar=⦞
syntax match Conceal '\<\%([mM]ath\.\)\?[cC]os\>' conceal cchar=∠
syntax match Conceal '\<\%([mM]ath\.\)\?[tT]an\>' conceal cchar=⊾
syntax match Conceal '\<\%([mM]ath\.\)\?[sS]um\>' conceal cchar=∑
syntax match Conceal '\<\%([mM]ath\.\)\?[sS]qrt\>' conceal cchar=√
syntax match Conceal '\<\%([mM]ath\.\)\?[cC]eil\>' conceal cchar=⌈
syntax match Conceal '\<\%([mM]ath\.\)\?[fF]loor\>' conceal cchar=⌊

" }}}

" vim: foldmethod=marker