Append string to -- INSERT / NORMAL -- in vi mode

[Strykar]

When pasting multiple lines, Multiline presents a nice colored help tip:
-- MULTILINE -- (RET or C-m: insert a newline, C-j: run)

How would I (optionally) suffix something similar in vim mode to the -- INSERT -- and NORMAL (~) vim mode lines?
Insert mode:
-- INSERT -- (RET or ⏎: insert a newline, Esc: returns to Normal, C-j: run)
Normal mode (instead of ~):
-- NORMAL -- (h◀ j▼ k▲ l▶: moves cursor, i/I: returns to Insert, C-j: run)

Happy to share a PR if I knew where to look.

I have been using vim for years, but I am not an advanced user, vi mode in ble.sh just blew me away.
I would help crowdfund an ascii-cinema version that details the myriad of settings and knobs ble.sh offers, it is astonishing!

[Strykar]

My mistake, should have checked the wiki -
https://github.com/akinomyoga/ble.sh/wiki/Vi-%28Vim%29-editing-mode#3-possible-preferences

Solution via ~/.blerc for anyone else interested:

function blerc/vim-mode-hook {
  bleopt keymap_vi_mode_show=1

  bleopt keymap_vi_mode_string_nmap=$'\e[1;36m-- NORMAL --\e[0m (\e[95mh\e[0m◀ \e[95mj\e[0m▼ \e[95mk\e[0m▲ \e[95ml\e[0m▶: moves cursor, \e[95mi/I\e[0m: returns to Insert, \e[95mC-j\e[0m: run)'
  bleopt keymap_vi_mode_name_insert=$'INSERT (\e[95mRET\e[0m or \e[95m⏎\e[0m: insert a newline, \e[95mEsc\e[0m: returns to Normal, \e[95mC-j\e[0m: run)'
}
blehook/eval-after-load keymap_vi blerc/vim-mode-hook

[Strykar]

@akinomyoga I have one more related question, I could not solve regarding this.
I currently have NORMAL and INSERT configured to show random rotating vim help tips from a text file, which works well:

#
function ble/vim/load-tip {
  local tips_file=~/.config/blesh/vim_tips.txt
  local tip_line cmd desc tip=""
  if [[ -r $tips_file ]]; then
    mapfile -t _ble_tips < "$tips_file"
    local count=${#_ble_tips[@]}
    if ((count > 0)); then
      local index_file=~/.cache/ble-tip-index
      local index=0
      if [[ -f $index_file ]]; then
        read -r index < "$index_file"
        index=$(( (index + 1) % count ))
      fi
      echo "$index" >| "$index_file"
      tip_line=${_ble_tips[index]}
      if [[ $tip_line =~ ^([^:]+):[[:space:]]*(.+)$ ]]; then
        cmd=${BASH_REMATCH[1]}
        desc=${BASH_REMATCH[2]}
        tip=$'\e[95m'"$cmd"$'\e[0m: '"$desc"
      else
        tip=$tip_line
      fi
    fi
  fi
  [[ -n $tip ]] && printf '%s' "$tip"
}

function ble/keymap:vi/update-mode-indicator {
  local tip
  tip=$(ble/vim/load-tip)

  local keymap
  ble/keymap:vi/script/get-vi-keymap || return 0

  local banner=
  case $keymap in
    vi_nmap)
      banner=$'\e[1;36m-- NORMAL --\e[0m' ;;
    vi_imap)
      banner=$'\e[1;36m-- INSERT --\e[0m' ;;
    *)
      return 1 ;;
  esac

  [[ -n $tip ]] && banner+=" ( Tip: $tip )"

  ble/edit/info/default ansi "$banner"
}

# In ~/.blerc
function override_vi_mode_indicator {
  function ble/keymap:vi/update-mode-indicator {
    local tip
    tip=$(ble/vim/load-tip)

    local keymap
    ble/keymap:vi/script/get-vi-keymap || return 0

    local banner
    case $keymap in
      vi_nmap) banner=$'\e[1;36m-- NORMAL --\e[0m' ;;
      vi_imap) banner=$'\e[1;36m-- INSERT --\e[0m' ;;
      *) return 1 ;;
    esac

    [[ -n $tip ]] && banner+=" ( Tip: $tip )"

    ble/edit/info/default ansi "$banner"
  }
}
blehook/eval-after-load keymap_vi override_vi_mode_indicator

When I try to integrate Ctrl+C to drop to shell with this, it works well in INSERT mode, but if I am editing multi-lines and move to NORMAL mode, I am unable to Ctrl+C to shell.

I am trying to get it to Ctrl+C in NORMAL mode and exit back into a default INSERT mode:

function ble/widget/discard-and-enter-insert {
  ble-edit/buffer#clear
  ble/decode/keymap vi_imap
}

function blerc/vim-mode-hook {
  ble-bind -m vi_imap -f 'C-c' discard-line
  ble-bind -m vi_nmap -f 'C-c' discard-and-enter-insert
}

blehook/eval-after-load keymap_vi blerc/vim-mode-hook

It either makes the prompt disappear (fixed by hitting enter) or it logs:

Type :q and press <Enter> to exit Bash

What am I missing here?

[akinomyoga]

function ble/widget/discard-and-enter-insert {
  ble-edit/buffer#clear
  ble/decode/keymap vi_imap
}

Where did this come from? There is no such function as ble-edit/buffer#clear or ble/decode/keymap. Even if it existed, you shouldn't call random internal functions without understanding them. You might be able to change a part of the internal state by calling some functions, but you actually need to adjust many different states to make it work. If you want to combine existing behaviors of widgets, you can just call the widgets in order:

function ble/widget/discard-and-enter-insert {
  ble/widget/discard-line
  ble/widget/vi_nmap/insert-mode
}

[Strykar]

Sorry I was playing around, your point is well received, and thank you very much for clearing this up!