feat: bullets_process_last_bullet_if_empty

Support promotion instead of deletion

Author: devsunb

README.md

@@ -107,10 +107,24 @@ let g:bullets_custom_mappings = [
   \ ]
 ```
 
-Enable/disable deleting the last empty bullet when hitting `<cr>` (insert mode) or `o` (normal mode):
+Enable/disable deleting or promoting the last empty bullet when hitting `<cr>` (insert mode) or `o` (normal mode):
 
 ```vim
-let g:bullets_delete_last_bullet_if_empty = 0 " default = 1
+let g:bullets_process_last_bullet_if_empty = 0 " default = 1
+" - text
+"   - text
+"   -
+"   -
+
+let g:bullets_process_last_bullet_if_empty = 1
+" - text
+"   - text
+"
+
+let g:bullets_process_last_bullet_if_empty = 2
+" - text
+"   - text
+" -
 ```
 
 Line spacing between bullets (1 = no blank lines, 2 = one blank line, etc.):

doc/bullets.txt

@@ -148,14 +148,18 @@ To add a leader key to all mappings set the following:
 This will set the <space> key as leader to all default mappings.
 
 
-Disabling empty bullet deletion
+Empty bullet processing
 -------------------------------
 By default bullets.vim will delete trailing empty bullets when the return key
 is pressed, just like modern word processors.
 
 If you would like to turn this feature off add the following to your .vimrc
 
-  `let g:bullets_delete_last_bullet_if_empty = 0`
+  `let g:bullets_process_last_bullet_if_empty = 0`
+
+If you would like to promote bullet instead of deleting it, add the following to your .vimrc
+
+  `let g:bullets_process_last_bullet_if_empty = 2`
 
 
 Maintain right padding on bullets

plugin/bullets.vim

@@ -44,8 +44,8 @@ if !exists('g:bullets_custom_mappings')
   let g:bullets_custom_mappings = []
 endif
 
-if !exists('g:bullets_delete_last_bullet_if_empty')
-  let g:bullets_delete_last_bullet_if_empty = 1
+if !exists('g:bullets_process_last_bullet_if_empty')
+  let g:bullets_process_last_bullet_if_empty = 1
 end
 
 if !exists('g:bullets_line_spacing')
@@ -573,8 +573,12 @@ fun! s:insert_new_bullet()
     if l:bullet.text_after_bullet ==# ''
       " We don't want to create a new bullet if the previous one was not used,
       " instead we want to delete the empty bullet - like word processors do
-      if g:bullets_delete_last_bullet_if_empty
-        call setline(l:curr_line_num, '')
+      if g:bullets_process_last_bullet_if_empty
+        if g:bullets_process_last_bullet_if_empty == 1
+          call setline(l:curr_line_num, '')
+        elseif g:bullets_process_last_bullet_if_empty == 2
+          call <SID>change_bullet_level(1, 0)
+        endif
         let l:send_return = 0
       endif
     elseif !(l:bullet.bullet_type ==# 'abc' && s:abc2dec(l:bullet.bullet) + 1 > s:abc_max)

spec/bullets_spec.rb

@@ -271,14 +271,39 @@
         TEXT
       end
 
+      it 'promote the last bullet when configured to' do
+        filename = "#{SecureRandom.hex(6)}.txt"
+        write_file(filename, <<-TEXT)
+          # Hello there
+          - this is the first bullet
+            - this is the second bullet
+        TEXT
+
+        vim.command 'let g:bullets_process_last_bullet_if_empty = 2'
+        vim.edit filename
+        vim.type 'GA'
+        vim.feedkeys '\<cr>'
+        vim.feedkeys '\<cr>'
+        vim.write
+
+        file_contents = IO.read(filename)
+
+        expect(file_contents.strip).to eq normalize_string_indent(<<-TEXT)
+          # Hello there
+          - this is the first bullet
+            - this is the second bullet
+          -
+        TEXT
+      end
+
       it 'does not delete the last bullet when configured not to' do
         filename = "#{SecureRandom.hex(6)}.txt"
         write_file(filename, <<-TEXT)
           # Hello there
           - this is the first bullet
         TEXT
 
-        vim.command 'let g:bullets_delete_last_bullet_if_empty = 0'
+        vim.command 'let g:bullets_process_last_bullet_if_empty = 0'
         vim.edit filename
         vim.type 'GA'
         vim.feedkeys '\<cr>'