From 92509905ab41c0adf7297ba8b1e7d5b94944b4d2 Mon Sep 17 00:00:00 2001
From: nojhan <nojhan@nojhan.net>
Date: Tue, 9 Feb 2021 15:58:56 +0100
Subject: [PATCH] feature: add the dotmatrix theme

The dotmatrix theme is basically the look of "powerline", but done right on the user experience side.
The main idea is to highlight what's important, instead of displaying too much things because fancy colors everywhere is fun.

To achieve that, the dotmatrix theme has been very carefully designed:
- it uses three four modules: host/path, machine state, environment, version control.
- it uses a consistent visual grammar (using 3 separators and 3 colors).
- it follows good practices for color blindness.

The current code use a similar approach to the one used for the powerline theme, but needs a refactoring.
---
 themes/dotmatrix/dotmatrix.theme              | 887 ++++++++++++++++++
 .../liquidprompt_dotmatrix_design.odt         | Bin 0 -> 17088 bytes
 2 files changed, 887 insertions(+)
 create mode 100644 themes/dotmatrix/dotmatrix.theme
 create mode 100644 themes/dotmatrix/liquidprompt_dotmatrix_design.odt

diff --git a/themes/dotmatrix/dotmatrix.theme b/themes/dotmatrix/dotmatrix.theme
new file mode 100644
index 0000000..0c819fb
--- /dev/null
+++ b/themes/dotmatrix/dotmatrix.theme
@@ -0,0 +1,887 @@
+
+########################################################################
+# API
+########################################################################
+
+_lp_dotmatrix_theme_activate() {
+
+    LP_ENABLE_VCS_DIFFSTATS=${LP_ENABLE_UNCOMMITED:-0}
+
+    DOTMATRIX_DISPLAY_TEXT=${DOTMATRIX_DISPLAY_TEXT:-"T"}
+    DOTMATRIX_DISPLAY_X11=${DOTMATRIX_DISPLAY_X11:-"X"}
+    DOTMATRIX_HOST_LOCAL=${POWERLINE_HOST_LOCAL:-"⌂"}
+    DOTMATRIX_MARK_STASH=${DOTMATRIX_MARK_STASH:-"✝"}
+    DOTMATRIX_MARK_UNTRACKED=${DOTMATRIX_MARK_UNTRACKED:-"?"} # ⛶
+    DOTMATRIX_DIFF=${DOTMATRIX_DIFF:-"≠"}
+
+    # Sets of characters
+    DOTMATRIX_VARIANT=${DOTMATRIX_VARIANT:-"dotmatrix"}
+    if [[ "${DOTMATRIX_VARIANT}" == "dotmatrix" ]] ; then
+        DOTMATRIX_SPACED=${DOTMATRIX_SPACED:-0}
+
+        # Dotmatrix theme
+        DOTMATRIX_HOST_LOCAL=${POWERLINE_HOST_LOCAL:-"⌂"}
+        DOTMATRIX_USER_LOCAL=${DOTMATRIX_USER_LOCAL:-"♟"}
+        DOTMATRIX_VCS=${DOTMATRIX_VCS:-"╟┘"}
+        DOTMATRIX_MARK=${DOTMATRIX_MARK:-"■"}
+        DOTMATRIX_LINE=${DOTMATRIX_LINE:-"━"}
+        DOTMATRIX_PLUG=${DOTMATRIX_PLUG:-"▛"}
+        DOTMATRIX_SOFT=${DOTMATRIX_SOFT:-"╱"}
+        DOTMATRIX_MEAN=${DOTMATRIX_MEAN:-"▞"}
+        # Separator arrays                                (left center right 
+        [[ -z ${DOTMATRIX_LINK[@]+x} ]] && DOTMATRIX_LINK=("▙" " "   "▜")
+        [[ -z ${DOTMATRIX_OPEN[@]+x} ]] && DOTMATRIX_OPEN=("▙" " ▚ " "▜")
+        [[ -z ${DOTMATRIX_DANG[@]+x} ]] && DOTMATRIX_DANG=("▙" " □ " "▜")
+        [[ -z ${DOTMATRIX_ENDS[@]+x} ]] && DOTMATRIX_ENDS=("▛▞▗ ▝" "▖ ▘▞▟")
+
+    elif [[ "${DOTMATRIX_VARIANT}" == "text" ]] ; then
+        DOTMATRIX_SPACED=${DOTMATRIX_SPACED:-0}
+
+        # Dotmatrix theme
+        DOTMATRIX_HOST_LOCAL=${POWERLINE_HOST_LOCAL:-"lcl"}
+        DOTMATRIX_USER_LOCAL=${DOTMATRIX_USER_LOCAL:-"me"}
+        DOTMATRIX_VCS=${DOTMATRIX_VCS:-"VCS"}
+        DOTMATRIX_MARK=${DOTMATRIX_MARK:-">"}
+        DOTMATRIX_LINE=${DOTMATRIX_LINE:-"━"}
+        DOTMATRIX_PLUG=${DOTMATRIX_PLUG:-"▌"}
+        DOTMATRIX_SOFT=${DOTMATRIX_SOFT:-"╱"}
+        DOTMATRIX_MEAN=${DOTMATRIX_MEAN:-"┃"}
+        # Separator arrays                                (left center right 
+        [[ -z ${DOTMATRIX_LINK[@]+x} ]] && DOTMATRIX_LINK=("▌" "<"   "▐")
+        [[ -z ${DOTMATRIX_OPEN[@]+x} ]] && DOTMATRIX_OPEN=("▌" "<<" "▐")
+        [[ -z ${DOTMATRIX_DANG[@]+x} ]] && DOTMATRIX_DANG=("▌" "<<<" "▐")
+        [[ -z ${DOTMATRIX_ENDS[@]+x} ]] && DOTMATRIX_ENDS=("▌···" "···▐")
+
+
+    elif [[ "${DOTMATRIX_VARIANT}" == "chevron"  ]] ; then
+        DOTMATRIX_SPACED=${DOTMATRIX_SPACED:-1}
+
+        # Powerline chevron theme
+        DOTMATRIX_HOST_LOCAL=${POWERLINE_HOST_LOCAL:-""}
+        DOTMATRIX_USER_LOCAL=${DOTMATRIX_USER_LOCAL:-""}
+        DOTMATRIX_VCS=${DOTMATRIX_VCS:-""}
+        DOTMATRIX_MARK=${DOTMATRIX_MARK:-""}
+        DOTMATRIX_LINE=${DOTMATRIX_LINE:-"━"}
+        DOTMATRIX_PLUG=${DOTMATRIX_PLUG:-""}
+        DOTMATRIX_SOFT=${DOTMATRIX_SOFT:-"╱"}
+        DOTMATRIX_MEAN=${DOTMATRIX_MEAN:-""}
+        [[ -z ${DOTMATRIX_LINK[@]+x} ]] && DOTMATRIX_LINK=("" ""   "")
+        [[ -z ${DOTMATRIX_OPEN[@]+x} ]] && DOTMATRIX_OPEN=("" ""  "")
+        [[ -z ${DOTMATRIX_DANG[@]+x} ]] && DOTMATRIX_DANG=("" "" "")
+        [[ -z ${DOTMATRIX_ENDS[@]+x} ]] && DOTMATRIX_ENDS=("" "")
+
+    elif [[ "${DOTMATRIX_VARIANT}" == "round"  ]] ; then
+        DOTMATRIX_SPACED=${DOTMATRIX_SPACED:-1}
+
+        # Powerline round theme
+        DOTMATRIX_HOST_LOCAL=${POWERLINE_HOST_LOCAL:-""}
+        DOTMATRIX_USER_LOCAL=${DOTMATRIX_USER_LOCAL:-""}
+        DOTMATRIX_VCS=${DOTMATRIX_VCS:-""}
+        DOTMATRIX_MARK=${DOTMATRIX_MARK:-""}
+        DOTMATRIX_LINE=${DOTMATRIX_LINE:-"━"}
+        DOTMATRIX_PLUG=${DOTMATRIX_PLUG:-""}
+        DOTMATRIX_SOFT=${DOTMATRIX_SOFT:-"╱"}
+        DOTMATRIX_MEAN=${DOTMATRIX_MEAN:-""}
+        [[ -z ${DOTMATRIX_LINK[@]+x} ]] && DOTMATRIX_LINK=("█" "" "")
+        [[ -z ${DOTMATRIX_OPEN[@]+x} ]] && DOTMATRIX_OPEN=("█" "" "")
+        [[ -z ${DOTMATRIX_DANG[@]+x} ]] && DOTMATRIX_DANG=("█" "" "")
+        [[ -z ${DOTMATRIX_ENDS[@]+x} ]] && DOTMATRIX_ENDS=("" "")
+
+    elif [[ "${DOTMATRIX_VARIANT}" == "slant"  ]] ; then
+        DOTMATRIX_SPACED=${DOTMATRIX_SPACED:-1}
+
+        # Powerline slanted theme
+        DOTMATRIX_HOST_LOCAL=${POWERLINE_HOST_LOCAL:-""}
+        DOTMATRIX_USER_LOCAL=${DOTMATRIX_USER_LOCAL:-""}
+        DOTMATRIX_VCS=${DOTMATRIX_VCS:-""}
+        DOTMATRIX_MARK=${DOTMATRIX_MARK:-""}
+        DOTMATRIX_LINE=${DOTMATRIX_LINE:-"━"}
+        DOTMATRIX_PLUG=${DOTMATRIX_PLUG:-""}
+        DOTMATRIX_SOFT=${DOTMATRIX_SOFT:-"╱"}
+        DOTMATRIX_MEAN=${DOTMATRIX_MEAN:-""}
+        [[ -z ${DOTMATRIX_LINK[@]+x} ]] && DOTMATRIX_LINK=("" "" "")
+        [[ -z ${DOTMATRIX_OPEN[@]+x} ]] && DOTMATRIX_OPEN=("" "" "")
+        [[ -z ${DOTMATRIX_DANG[@]+x} ]] && DOTMATRIX_DANG=("" "" "")
+        [[ -z ${DOTMATRIX_ENDS[@]+x} ]] && DOTMATRIX_ENDS=("" "")
+
+    fi
+
+    # Number of spaces to add
+    if [[ ${DOTMATRIX_SPACED} == 0 ]] ; then
+        DOTMATRIX_SPACE_VOID=""
+        DOTMATRIX_SPACE_FILL=""
+        DOTMATRIX_SPACE_PATH=${DOTMATRIX_SPACE_PATH:-""}
+        DOTMATRIX_SPACE_FIELD=${DOTMATRIX_SPACE_FIELD:-""}
+
+    elif [[ ${DOTMATRIX_SPACED} == 1 ]] ; then
+        DOTMATRIX_SPACE_VOID=" "
+        DOTMATRIX_SPACE_FILL="█"
+        DOTMATRIX_SPACE_PATH=${DOTMATRIX_SPACE_PATH:-" "}
+        DOTMATRIX_SPACE_FIELD=${DOTMATRIX_SPACE_FIELD:-""}
+    else
+        DOTMATRIX_SPACE_VOID=$(printf '%0.s ' $(seq 1 ${DOTMATRIX_SPACED})) # Regular space
+        DOTMATRIX_SPACE_FILL=$(printf '%0.s█' $(seq 1 ${DOTMATRIX_SPACED})) # Inverted space
+        DOTMATRIX_SPACE_PATH=${DOTMATRIX_SPACE_PATH:-"${DOTMATRIX_SPACE_VOID}"}
+        DOTMATRIX_SPACE_FIELD=${DOTMATRIX_SPACE_FIELD:-""}
+    fi
+
+
+    # Color arrays defaults                                          fg bg b u ffg fbg
+    [[ -z ${DOTMATRIX_COLOR_DARK[@]+x} ]] && DOTMATRIX_COLOR_DARK=(252 239 0 0  15   0)
+    [[ -z ${DOTMATRIX_COLOR_LITE[@]+x} ]] && DOTMATRIX_COLOR_LITE=(239 252 0 0   0  15)
+    [[ -z ${DOTMATRIX_COLOR_GLOW[@]+x} ]] && DOTMATRIX_COLOR_GLOW=(  0 252 1 0   0  15)
+    [[ -z ${DOTMATRIX_COLOR_NOTE[@]+x} ]] && DOTMATRIX_COLOR_NOTE=( 15  33 0 0  15  12)
+    [[ -z ${DOTMATRIX_COLOR_WARN[@]+x} ]] && DOTMATRIX_COLOR_WARN=(196 220 1 0   0  11)
+    [[ -z ${DOTMATRIX_COLOR_FAIR[@]+x} ]] && DOTMATRIX_COLOR_FAIR=(  0 244 0 0   0   8)
+
+    [[ -z ${DOTMATRIX_COLOR_PATH_SHORT[@]+x} ]] && DOTMATRIX_COLOR_PATH_SHORT=(252 239 0 0   0  15)
+    [[ -z ${DOTMATRIX_COLOR_PATH_VCS[@]+x}   ]] && DOTMATRIX_COLOR_PATH_VCS=(252 239 0 1   0  15)
+    [[ -z ${DOTMATRIX_COLOR_PATH_LAST[@]+x}  ]] && DOTMATRIX_COLOR_PATH_LAST=(15 239 1 0   0  15)
+
+    [[ -z ${DOTMATRIX_COLOR_LINE[@]+x}  ]] && DOTMATRIX_COLOR_LINE=(244 -1 0 0 15 -1)
+    # [[ -z ${DOTMATRIX_COLOR_LINE_START[@]+x}  ]] && DOTMATRIX_COLOR_LINE_START=(255 -1 1 0 15 -1)
+    # [[ -z ${DOTMATRIX_COLOR_LINE_END[@]+x}    ]] && DOTMATRIX_COLOR_LINE_END=(232 -1 1 0 15 -1)
+
+    [[ -z ${DOTMATRIX_COLOR_MARK[@]+x}  ]] && DOTMATRIX_COLOR_MARK=(15 -1 0 0 15 -1)
+
+    [[ -z ${DOTMATRIX_COLOR_SEP_DARK[@]+x} ]] && DOTMATRIX_COLOR_SEP_DARK=(  0 -2 0 0  0 -2)
+    [[ -z ${DOTMATRIX_COLOR_SEP_FAIR[@]+x} ]] && DOTMATRIX_COLOR_SEP_FAIR=(244 -2 0 0  0 -2)
+    [[ -z ${DOTMATRIX_COLOR_SEP_LITE[@]+x} ]] && DOTMATRIX_COLOR_SEP_LITE=( 15 -2 0 0 15 -2)
+
+    __dotmatrix_activate_display
+    __dotmatrix_activate_connection
+    __dotmatrix_activate_user
+    __dotmatrix_activate_multiplexer
+    __dotmatrix_activate_hostname
+}
+
+
+_lp_dotmatrix_theme_directory() {
+    lp_terminal_format "${DOTMATRIX_COLOR_LITE[@]}"
+    __dotmatrix_directory_FS
+    __dotmatrix_directory_path
+}
+
+
+_lp_dotmatrix_theme_prompt() {
+
+    local header inline prompt
+
+    # Arguments: fg, bg, bold, underline, fallback_fg, fallback_bg
+    # Color codes can be any integer in 256 XTerm's system colors in [0–255].
+    # Special color codes:
+    #   -1 : no color
+    #   -2 : previously set color
+    #   -3 : swap fg and bg
+    local lp_terminal_format
+
+    ####################################################################
+    # HEADER (LEFT)
+    ####################################################################
+
+    header=""
+    header+="${_DOTMATRIX_DISPLAY}"
+    header+="${_DOTMATRIX_CONNECTION}"
+    header+="${_DOTMATRIX_USER}"
+    header+="${_DOTMATRIX_MULTIPLEXER}"
+    header+="${_DOTMATRIX_HOSTNAME}"
+    header+="${_DOTMATRIX_FS}"
+    header+="${_DOTMATRIX_PATH} "
+
+    if _lp_dirstack; then
+        __dotmatrix_make_sep_plug "${DOTMATRIX_COLOR_LITE[@]}"
+        header+="${dotmatrix_sep}"
+        __dotmatrix_make_field "${lp_dirstack}" "${DOTMATRIX_COLOR_LITE[@]}"
+        header+="${dotmatrix_field}"
+    else
+        # Recall a dark format to correctly reset sections history
+        # to match the path's section colors.
+        lp_terminal_format "${DOTMATRIX_COLOR_DARK[@]}"
+    fi
+
+    __dotmatrix_make_sep_last
+    header+="${dotmatrix_sep}"
+
+    ####################################################################
+    # HEADER SIDE (RIGHT)
+    ####################################################################
+
+    __dotmatrix_make_sep_side ""
+    side="${dotmatrix_sep}"
+
+    # battery / load / temperature
+    __dotmatrix_make_sep_plug "${DOTMATRIX_COLOR_DARK[@]}"
+    local blt_plug="${dotmatrix_sep}"
+
+    local battery=""
+    if _lp_battery ; then
+        __dotmatrix_make_field "$lp_battery" "${DOTMATRIX_COLOR_DARK[@]}"
+        battery="${dotmatrix_field}${LP_MARK_BATTERY}"
+    fi
+
+    local load=""
+    if _lp_load ; then
+        __dotmatrix_make_field "$lp_load" "${DOTMATRIX_COLOR_DARK[@]}"
+        load="${dotmatrix_field}${LP_MARK_LOAD}"
+    fi
+
+    local temperature=""
+    if _lp_temperature ; then
+        __dotmatrix_make_field "$lp_temperature" "${DOTMATRIX_COLOR_DARK[@]}"
+        temperature="${dotmatrix_field}${LP_MARK_TEMP}"
+    fi
+
+    __dotmatrix_make_sep_soft "${DOTMATRIX_COLOR_SEP_DARK[@]}"
+    # Non-bracketed variables are intentionals,
+    # so that if the variable is null, it does not count in the arguments array.
+    __dotmatrix_join_fields "$dotmatrix_sep" $battery $load $temperature
+    if [[ -n "$dotmatrix_join_fields" ]] ; then
+        side+="${blt_plug}${dotmatrix_join_fields}"
+    else
+        lp_terminal_format "${DOTMATRIX_COLOR_FAIR[@]}"
+        side+="${lp_terminal_format}"
+    fi
+
+    # jobs: detached / running / stopped
+    __dotmatrix_make_sep_plug "${DOTMATRIX_COLOR_LITE[@]}"
+    local djc_plug="${dotmatrix_sep}"
+
+    local detached_sessions=""
+    if _lp_detached_sessions ; then
+        if [[ -n "${lp_detached_sessions}" && "${lp_detached_sessions}" > 0 ]] ; then
+            __dotmatrix_make_field "${lp_detached_sessions}d" "${DOTMATRIX_COLOR_LITE[@]}"
+            detached_sessions="${dotmatrix_field}"
+        fi
+    fi
+
+    local running_jobs=""
+    local stopped_jobs=""
+    if _lp_jobcount ; then
+        if [[ -n "${lp_running_jobs}" && "${lp_running_jobs}" > 0  ]] ; then
+            __dotmatrix_make_field "${lp_running_jobs}&" "${DOTMATRIX_COLOR_LITE[@]}"
+            running_jobs="${dotmatrix_field}"
+        fi
+
+        if [[ -n "${lp_stopped_jobs}" && "${lp_stopped_jobs}" > 0  ]] ; then
+            __dotmatrix_make_field "${lp_stopped_jobs}z" "${DOTMATRIX_COLOR_LITE[@]}"
+            stopped_jobs="${dotmatrix_field}"
+        fi
+    fi
+
+    __dotmatrix_make_sep_soft "${DOTMATRIX_COLOR_SEP_LITE[@]}"
+    __dotmatrix_join_fields "$dotmatrix_sep" ${detached_sessions} ${running_jobs} ${stopped_jobs}
+    if [[ -n "$dotmatrix_join_fields" ]] ; then
+        side+="${djc_plug}${dotmatrix_join_fields}"
+    else
+        lp_terminal_format "${DOTMATRIX_COLOR_FAIR[@]}"
+        side+="${lp_terminal_format}"
+    fi
+
+    # clock
+    if _lp_time ; then
+        __dotmatrix_make_sep_plug "${DOTMATRIX_COLOR_DARK[@]}"
+        side+="${dotmatrix_sep}"
+        if _lp_analog_time ; then
+            __dotmatrix_make_field "$lp_analog_time" "${DOTMATRIX_COLOR_DARK[@]}"
+            side+="$dotmatrix_field"
+        else
+            __dotmatrix_make_field "$lp_time" "${DOTMATRIX_COLOR_DARK[@]}"
+            side+="$dotmatrix_field"
+        fi
+    fi
+
+    # Merge side in header
+    local side_as_text="$(_lp_as_text "${side}")"
+    local head_as_text="$(_lp_as_text "${header}")"
+    # FIXME within SSH, COLUMNS seems to be broken
+    local head_width=$((${COLUMNS}-${#side_as_text}-${#head_as_text}))
+    #-6)) # Why -6? I have no idea.
+    if [[ $head_width -lt 0 ]] ; then
+        head_width=0
+    fi
+
+    local spaced_side+=$(printf "%.0s " $(seq ${head_width}))
+
+    header+="${spaced_side}${side}"
+
+    ####################################################################
+    # IN LINE
+    ####################################################################
+
+    inline="$LP_PS1_PREFIX"
+
+    local lp_terminal_format
+    lp_terminal_format "${DOTMATRIX_COLOR_LINE[@]}"
+
+    local inline_width
+    if _lp_software_collections ; then
+        inline+="${inline} ${lp_software_collections} "
+    fi
+    if _lp_python_env ; then
+        inline+="${inline} ${lp_python_env} "
+    fi
+    local as_text="$(_lp_as_text "${inline}")"
+    inline_width=$((${COLUMNS}-${#as_text}))
+
+    # Fill up the remaining space.
+    inline+="${lp_terminal_format}$(printf "%.0s${DOTMATRIX_LINE}" $(seq ${inline_width}))"
+
+    # Gradient line: too slow (or not enough optimized? check COLUMNS change before recompute?)
+    # for i in $(seq ${inline_width}) ; do
+    #     local dash_color=()
+    #     for c in $(seq 0 $((${#DOTMATRIX_COLOR_LINE_START[@]}-1)) ); do
+    #         f=$(bc -l <<< "$i / ${inline_width}")
+    #         a=${DOTMATRIX_COLOR_LINE_START[c]}
+    #         b=${DOTMATRIX_COLOR_LINE_END[c]}
+    #         j=$(LC_ALL=C;printf "%.*f" 0 "$(bc -l <<< "($a)+(($b)-($a))*($f)")")
+    #         dash_color+=($j)
+    #     done
+    #
+    #     lp_terminal_format ${dash_color[@]}
+    #     inline+="${lp_terminal_format}${inline}"
+    # done
+
+    ####################################################################
+    # PROMPT LINE
+    ####################################################################
+
+    prompt=""
+    lp_terminal_format "${DOTMATRIX_COLOR_DARK[@]}"
+    prompt+="${lp_terminal_format}·" # Put internet here when (if) it's done.
+
+    local net_sep_color="${DOTMATRIX_COLOR_LITE[@]}"
+    if _lp_find_vcs && _lp_vcs_commits_off_remote ; then
+
+        if _lp_http_proxy ; then
+            __dotmatrix_make_sep_link "${DOTMATRIX_COLOR_LITE[@]}"
+            prompt+="${dotmatrix_sep}"
+        else
+            __dotmatrix_make_sep_plug "${DOTMATRIX_COLOR_LITE[@]}"
+            prompt+="${dotmatrix_sep}"
+        fi
+    else
+        if _lp_http_proxy ; then
+            __dotmatrix_make_sep_link "${DOTMATRIX_COLOR_DARK[@]}"
+            prompt+="${dotmatrix_sep}"
+        else
+            __dotmatrix_make_sep_mid "${DOTMATRIX_COLOR_DARK[@]}"
+            prompt+="${dotmatrix_sep}${DOTMATRIX_SPACE_VOID}"
+        fi
+
+    fi
+
+    __dotmatrix_prompt_vcs
+    prompt+="${_DOTMATRIX_VCS}"
+
+    if _lp_runtime_format ; then
+        __dotmatrix_make_sep_plug "${DOTMATRIX_COLOR_NOTE[@]}"
+        __dotmatrix_make_field "${lp_runtime_format}" "${DOTMATRIX_COLOR_NOTE[@]}"
+        prompt+="${dotmatrix_sep}${dotmatrix_field}"
+    fi
+
+    if _lp_error ; then
+        __dotmatrix_make_sep_plug "${DOTMATRIX_COLOR_WARN[@]}"
+        __dotmatrix_make_field "${lp_error}" "${DOTMATRIX_COLOR_WARN[@]}"
+        prompt+="${dotmatrix_sep}${dotmatrix_field}"
+    fi
+
+    __dotmatrix_make_sep_plug "${DOTMATRIX_COLOR_MARK[@]}"
+    prompt+="${dotmatrix_sep}"
+    lp_terminal_format "${DOTMATRIX_COLOR_MARK[@]}"
+    prompt+="${lp_terminal_format}${DOTMATRIX_MARK}"
+    prompt+="${NO_COL}"
+
+    # Assemble and setup
+    PS1="\n${header}\n${inline}\n${prompt} "
+}
+
+
+########################################################################
+# Functions called at "activate" stage.
+########################################################################
+
+__dotmatrix_activate_display() {
+    if _lp_connected_display ; then
+        __dotmatrix_make_field "${DOTMATRIX_DISPLAY_X11}" "${DOTMATRIX_COLOR_LITE[@]}"
+        _DOTMATRIX_DISPLAY=${dotmatrix_field}
+    else
+        __dotmatrix_make_field "${DOTMATRIX_DISPLAY_TEXT}" "${DOTMATRIX_COLOR_DARK[@]}"
+        _DOTMATRIX_DISPLAY=${dotmatrix_field}
+    fi
+}
+
+
+__dotmatrix_activate_connection() {
+    _lp_user
+    user_type=$?
+    local user_color
+    case $user_type in
+        0) # logged-in user
+            user_color=(${DOTMATRIX_COLOR_DARK[@]})
+            ;;
+        1) # other user
+            user_color=(${DOTMATRIX_COLOR_NOTE[@]})
+            ;;
+        2) # root
+            user_color=(${DOTMATRIX_COLOR_WARN[@]})
+            ;;
+    esac
+
+
+    local connection
+    _lp_connection
+        case "$lp_connection" in
+        lcl)
+            __dotmatrix_make_sep_plug "${user_color[@]}"
+            connection="${dotmatrix_sep}"
+            ;;
+        su)
+            _dotmatrix_make_sep_link "${user_color[@]}"
+            connection="${dotmatrix_sep}"
+            ;;
+        ssh)
+            __dotmatrix_make_sep_open "${user_color[@]}"
+            connection="${dotmatrix_sep}"
+            ;;
+        tel)
+            _dotmatrix_make_sep_dang "${user_color[@]}"
+            connection="${dotmatrix_sep}"
+            ;;
+        *)
+            __dotmatrix_make_sep_plug "${user_color[@]}"
+            connection="${dotmatrix_sep}"
+            ;;
+        esac
+
+    _DOTMATRIX_CONNECTION="${connection}"
+}
+
+
+__dotmatrix_activate_user() {
+    _lp_user
+    user_type=$?
+    case $user_type in
+        0) # logged-in user
+            if [[ -z "${lp_username}" ]] ; then # Honors LP_USER_ALWAYS
+                __dotmatrix_make_field "${DOTMATRIX_USER_LOCAL}" "${DOTMATRIX_COLOR_DARK[@]}"
+                _DOTMATRIX_USER="${dotmatrix_field}"
+            else
+                __dotmatrix_make_field "${lp_username}" "${DOTMATRIX_COLOR_DARK[@]}"
+                _DOTMATRIX_USER="${dotmatrix_field}"
+            fi
+            ;;
+        1) # other user
+            _lp_username_color
+            __dotmatrix_make_field "${lp_username_color}" "${DOTMATRIX_COLOR_NOTE[@]}"
+            _DOTMATRIX_USER="${dotmatrix_field}"
+            ;;
+        2) # root
+            _lp_username
+            __dotmatrix_make_field "${lp_username}" "${DOTMATRIX_COLOR_WARN[@]}"
+            _DOTMATRIX_USER="${dotmatrix_field}"
+            ;;
+    esac
+    return $user_type
+}
+
+
+__dotmatrix_activate_hostname() {
+    local hostname
+    if _lp_hostname; then
+        case "$lp_connection" in
+        ssh)
+            hostname="${lp_hostname}"
+            ;;
+        tel)
+            hostname="${lp_hostname}"
+            ;;
+        *)
+            hostname+="${DOTMATRIX_HOST_LOCAL}"
+            ;;
+        esac
+    else
+        hostname="${DOTMATRIX_HOST_LOCAL}"
+    fi
+
+    __dotmatrix_make_field "${hostname}" "${DOTMATRIX_COLOR_LITE[@]}"
+    _DOTMATRIX_HOSTNAME="${dotmatrix_field}"
+}
+
+
+__dotmatrix_activate_multiplexer() {
+    local multiplexer
+    if _lp_multiplexer ; then
+        case "$lp_multiplexer" in
+            tmux)
+                __dotmatrix_make_sep_link "${DOTMATRIX_COLOR_LITE[@]}"
+                multiplexer="${dotmatrix_sep}"
+                ;;
+            screen)
+                __dotmatrix_make_sep_link "${DOTMATRIX_COLOR_LITE[@]}"
+                multiplexer="${dotmatrix_sep}"
+                ;;
+            *)
+                __dotmatrix_make_sep_link "${DOTMATRIX_COLOR_LITE[@]}"
+                multiplexer="${dotmatrix_sep}"
+                ;;
+        esac
+    else
+        __dotmatrix_make_sep_plug "${DOTMATRIX_COLOR_LITE[@]}"
+        multiplexer="${dotmatrix_sep}"
+    fi
+
+    _DOTMATRIX_MULTIPLEXER="${multiplexer}"
+}
+
+
+########################################################################
+# Functions called at directory change.
+########################################################################
+
+__dotmatrix_directory_FS() {
+    local fs
+    if (( LP_ENABLE_PERM )); then
+        if _lp_chroot ; then
+            if [[ -w "${PWD}" ]]; then
+                __dotmatrix_make_sep_open "${DOTMATRIX_COLOR_DARK[@]}"
+                fs="${dotmatrix_sep}"
+            else
+                _dotmatrix_make_sep_dang "${DOTMATRIX_COLOR_DARK[@]}"
+                fs="${dotmatrix_sep}"
+            fi
+        else
+            if [[ -w "${PWD}" ]]; then
+                __dotmatrix_make_sep_plug "${DOTMATRIX_COLOR_DARK[@]}"
+                fs="${dotmatrix_sep}"
+            else
+                __dotmatrix_make_sep_link "${DOTMATRIX_COLOR_DARK[@]}"
+                fs="${dotmatrix_sep}"
+            fi
+        fi
+    fi
+    _DOTMATRIX_FS="${fs}"
+}
+
+
+__dotmatrix_directory_path() {
+    local lp_terminal_format
+
+    lp_terminal_format "${DOTMATRIX_COLOR_DARK[@]}"
+    local path_format="${lp_terminal_format}"
+
+    lp_terminal_format "${DOTMATRIX_COLOR_SEP_DARK[@]}"
+    local separator_format=$lp_terminal_format
+
+    lp_terminal_format "${DOTMATRIX_COLOR_PATH_SHORT[@]}"
+    local shortened_format=$lp_terminal_format
+
+    lp_terminal_format "${DOTMATRIX_COLOR_PATH_VCS[@]}"
+    local vcs_format=$lp_terminal_format
+
+    lp_terminal_format "${DOTMATRIX_COLOR_PATH_LAST[@]}"
+    local last_dir_format=$lp_terminal_format
+
+    local lp_path_format
+    _lp_path_format "$path_format" "$last_dir_format" "$vcs_format" "$shortened_format" \
+        "${DOTMATRIX_SPACE_PATH}${DOTMATRIX_SOFT}${DOTMATRIX_SPACE_PATH}" "$separator_format"
+
+    _DOTMATRIX_PATH=${lp_path_format}
+}
+
+
+########################################################################
+# Functions called at prompt update.
+########################################################################
+
+__dotmatrix_prompt_vcs() {
+    if _lp_find_vcs ; then
+        local lp_vcs_details_color
+
+        _lp_smart_mark
+
+        # Mark & commits off remote
+        local has_commit=
+        if _lp_vcs_commits_off_remote; then
+            __dotmatrix_make_field "${DOTMATRIX_VCS}${lp_smart_mark}" "${DOTMATRIX_COLOR_NOTE[@]}"
+            _DOTMATRIX_VCS="${dotmatrix_field}"
+
+            __dotmatrix_make_sep_link "${DOTMATRIX_COLOR_NOTE[@]}"
+            _DOTMATRIX_VCS+="${dotmatrix_sep}"
+
+            if (( LP_ENABLE_VCS_DIFFSTATS )) ; then
+                if [[ "$lp_vcs_commit_ahead" -ne "0" && "$lp_vcs_commit_behind" -ne "0" ]]; then
+                    __dotmatrix_make_field "+$lp_vcs_commit_ahead" "${DOTMATRIX_COLOR_NOTE[@]}"
+                    has_commit+="${dotmatrix_field}"
+                    __dotmatrix_make_sep_soft "${DOTMATRIX_COLOR_NOTE[@]}"
+                    has_commit+="${dotmatrix_sep}"
+                    __dotmatrix_make_field "-$lp_vcs_commit_behind" "${DOTMATRIX_COLOR_NOTE[@]}"
+                    has_commit+="${dotmatrix_field}"
+
+                elif [[ "$lp_vcs_commit_ahead" -ne "0" ]]; then
+                    __dotmatrix_make_field "+$lp_vcs_commit_ahead" "${DOTMATRIX_COLOR_NOTE[@]}"
+                    has_commit+="${dotmatrix_field}"
+
+                elif [[ "$lp_vcs_commit_behind" -ne "0" ]]; then
+                    __dotmatrix_make_field "-$lp_vcs_commit_behind" "${DOTMATRIX_COLOR_NOTE[@]}"
+                    has_commit+="${dotmatrix_field}"
+                fi
+                _DOTMATRIX_VCS+="${has_commit}"
+            else
+                __dotmatrix_make_field "${DOTMATRIX_DIFF}" "${DOTMATRIX_COLOR_NOTE[@]}"
+                _DOTMATRIX_VCS+="${dotmatrix_field}"
+            fi # LP_ENABLE_VCS_DIFFSTATS
+
+            __dotmatrix_make_sep_plug "${DOTMATRIX_COLOR_LITE[@]}"
+            _DOTMATRIX_VCS+="${dotmatrix_sep}"
+
+        else # No commit off remote
+            __dotmatrix_make_field "${DOTMATRIX_VCS}${lp_smart_mark}" "${DOTMATRIX_COLOR_DARK[@]}"
+            _DOTMATRIX_VCS="${dotmatrix_field}"
+            __dotmatrix_make_sep_plug "${DOTMATRIX_COLOR_LITE[@]}"
+            _DOTMATRIX_VCS+="${dotmatrix_sep}"
+        fi # commits off remote
+
+        # Branch:bookmark/tag
+        if _lp_vcs_branch; then
+            __dotmatrix_make_field "${lp_vcs_branch}" "${DOTMATRIX_COLOR_GLOW[@]}"
+            _DOTMATRIX_VCS+="${dotmatrix_field}"
+
+            if _lp_vcs_bookmark; then
+                __dotmatrix_make_field ":${lp_vcs_bookmark}" "${DOTMATRIX_COLOR_LITE[@]}"
+                _DOTMATRIX_VCS+="${dotmatrix_field}"
+            fi
+            if _lp_vcs_tag; then
+                __dotmatrix_make_sep_soft "${DOTMATRIX_COLOR_SEP_LITE[@]}"
+                __dotmatrix_make_field "${lp_vcs_tag}" "${DOTMATRIX_COLOR_LITE[@]}"
+                _DOTMATRIX_VCS+="${dotmatrix_sep}${dotmatrix_field}"
+            fi
+
+        elif _lp_vcs_bookmark; then
+            __dotmatrix_make_field "${lp_vcs_bookmark}" "${DOTMATRIX_COLOR_GLOW[@]}"
+            _DOTMATRIX_VCS+="${dotmatrix_field}"
+        elif _lp_vcs_tag; then
+            __dotmatrix_make_field "${lp_vcs_tag}" "${DOTMATRIX_COLOR_GLOW[@]}"
+            _DOTMATRIX_VCS+="${dotmatrix_field}"
+        else
+            _lp_vcs_commit_id
+            branch="${lp_vcs_commit_id:0:7}"
+            __dotmatrix_make_field "${lp_vcs_commit_id:0:7}" "${DOTMATRIX_COLOR_GLOW[@]}"
+            _DOTMATRIX_VCS+="${dotmatrix_field}"
+        fi # vcs branch
+
+        # Diff stats
+        local ret has_lines=
+        if _lp_vcs_uncommitted_files; then
+            __dotmatrix_make_sep_link "${DOTMATRIX_COLOR_NOTE[@]}"
+            _DOTMATRIX_VCS+="${dotmatrix_sep}"
+
+            _lp_vcs_unstaged_lines; ret=$?
+            # Only show unstaged changes if the VCS supports staging, otherwise
+            # show uncommitted changes
+            if (( ret == 0 )); then
+                if [[ "$lp_vcs_unstaged_i_lines" == "$lp_vcs_unstaged_d_lines" ]] ; then
+                    # If same number of lines inserted and deleted: display a single number.
+                    __dotmatrix_make_field "±$lp_vcs_unstaged_i_lines" "${DOTMATRIX_COLOR_NOTE[@]}"
+                    has_lines="${dotmatrix_field}"
+                else
+                    __dotmatrix_make_field "+$lp_vcs_unstaged_i_lines" "${DOTMATRIX_COLOR_NOTE[@]}"
+                    has_lines="${dotmatrix_field}"
+                    __dotmatrix_make_sep_soft "${DOTMATRIX_COLOR_SEP_NOTE[@]}"
+                    has_lines+="$dotmatrix_sep"
+                    __dotmatrix_make_field "-$lp_vcs_unstaged_d_lines" "${DOTMATRIX_COLOR_NOTE[@]}"
+                    has_lines+="${dotmatrix_field}"
+                fi
+
+            elif (( ret == 1 )); then
+                __dotmatrix_make_field "±0" "${DOTMATRIX_COLOR_DARK[@]}"
+                has_lines="+${dotmatrix_field}"
+            else
+                _lp_vcs_uncommitted_lines
+                if [[ "$lp_vcs_uncommitted_i_lines" == "$lp_vcs_uncommitted_d_lines" ]] ; then
+                    __dotmatrix_make_field "±$lp_vcs_uncommitted_i_lines" "${DOTMATRIX_COLOR_NOTE[@]}"
+                    has_lines="${dotmatrix_field}"
+                else
+                    __dotmatrix_make_field "+$lp_vcs_uncommitted_i_lines" "${DOTMATRIX_COLOR_NOTE[@]}"
+                    has_lines="${dotmatrix_field}"
+                    __dotmatrix_make_sep_soft "${DOTMATRIX_COLOR_SEP_NOTE[@]}"
+                    has_lines+="$dotmatrix_sep"
+                    __dotmatrix_make_field "-$lp_vcs_uncommitted_d_lines" "${DOTMATRIX_COLOR_NOTE[@]}"
+                    has_lines+="${dotmatrix_field}"
+                fi
+            fi
+            if (( LP_ENABLE_VCS_DIFFSTATS )) ; then
+                _DOTMATRIX_VCS+="${has_lines}"
+            else
+                __dotmatrix_make_field "${DOTMATRIX_DIFF}" "${DOTMATRIX_COLOR_NOTE[@]}"
+                _DOTMATRIX_VCS+="${dotmatrix_field}"
+            fi # LP_ENABLE_VCS_DIFFSTATS
+        fi # uncommitted files
+
+        # Stash / untracked / head
+        local stash= untracked= head=
+        if _lp_vcs_stash_count; then
+            stash="$DOTMATRIX_MARK_STASH"
+        fi
+        if _lp_vcs_untracked_files; then
+            untracked="$DOTMATRIX_MARK_UNTRACKED"
+        fi
+        if _lp_vcs_head_status; then
+            head="$lp_vcs_head_status"
+            # if [[ -n "${lp_vcs_head_details-}" ]]; then
+            # pass
+            # fi
+        fi
+        if [[ -n "$stash" || -n "$untracked" || -n "$head" ]] ; then
+            if [[ -z "$has_lines" ]] ; then
+                __dotmatrix_make_sep_mid "${DOTMATRIX_COLOR_SEP_FAIR[@]}"
+                _DOTMATRIX_VCS+=" $dotmatrix_sep "
+            else
+                __dotmatrix_make_sep_plug "${DOTMATRIX_COLOR_LITE[@]}"
+                _DOTMATRIX_VCS+="$dotmatrix_sep"
+            fi
+        fi
+
+        if [[ -n "$stash" ]] ; then
+            __dotmatrix_make_field "$stash" "${DOTMATRIX_COLOR_LITE[@]}"
+            _DOTMATRIX_VCS+="$dotmatrix_field"
+            if [[ -n "$untracked" ]] ; then
+                __dotmatrix_make_field "$untracked" "${DOTMATRIX_COLOR_LITE[@]}"
+                __dotmatrix_make_sep_soft "${DOTMATRIX_COLOR_SEP_LITE[@]}"
+                _DOTMATRIX_VCS+="${dotmatrix_sep}${dotmatrix_field}"
+            fi
+            if [[ -n "$head" ]] ; then
+                __dotmatrix_make_field "$head" "${DOTMATRIX_COLOR_LITE[@]}"
+                __dotmatrix_make_sep_soft "${DOTMATRIX_COLOR_SEP_LITE[@]}"
+                _DOTMATRIX_VCS+="${dotmatrix_sep}${dotmatrix_field}"
+            fi
+        else # no stash
+            if [[ -n "$untracked" ]] ; then
+                __dotmatrix_make_field "$untracked" "${DOTMATRIX_COLOR_LITE[@]}"
+                _DOTMATRIX_VCS+="${dotmatrix_field}"
+                if [[ -n "$head" ]] ; then
+                    __dotmatrix_make_field "$head" "${DOTMATRIX_COLOR_LITE[@]}"
+                    __dotmatrix_make_sep_soft "${DOTMATRIX_COLOR_SEP_LITE[@]}"
+                    _DOTMATRIX_VCS+="${dotmatrix_sep}${dotmatrix_field}"
+                fi
+            else # no untracked
+                if [[ -n "$head" ]] ; then
+                    __dotmatrix_make_field "$head" "${DOTMATRIX_COLOR_LITE[@]}"
+                    _DOTMATRIX_VCS+="${dotmatrix_field}"
+                fi
+            fi
+        fi # stash
+        return 1
+    else
+        _DOTMATRIX_VCS=""
+        return 0
+    fi # find_vcs
+}
+
+########################################################################
+# Helper functions
+########################################################################
+
+__dotmatrix_join_fields() {
+    dotmatrix_join_fields=""
+    local sep=${1-}
+    shift
+    if [[ -n "$@" ]] ; then
+        local first_field=${1-}
+        shift
+        dotmatrix_join_fields="${first_field}"
+        for f in "$@"; do
+            dotmatrix_join_fields+="${sep}${f}"
+        done
+    fi
+}
+
+__dotmatrix_make_field() { # string, (color array)
+    local lp_terminal_format string=${1-}
+    shift
+
+    [[ -z $string ]] && return 1
+
+    lp_terminal_format "$@"
+
+    dotmatrix_field="${lp_terminal_format}${DOTMATRIX_SPACE_FIELD}${string}${DOTMATRIX_SPACE_FIELD}"
+}
+
+__dotmatrix_make_sep_plug() { # color
+    # fg, bg, bold, underline, fallback_fg, fallback_bg
+    #  0 = set last color to current color
+    # -1 = set color to last color
+    # -2 = keep last color
+    # -3 = set last fg to last bg (and conversely)
+    local lp_terminal_format sep
+    sep="${DOTMATRIX_PLUG}"
+    if [[ "${_lp_last_ab_color-}" == "${2-}" ]] ; then
+        sep="${DOTMATRIX_MEAN}"
+    fi
+    lp_terminal_format -3 "${2-}" 0 0 -1 "${6-}"
+    dotmatrix_sep="${DOTMATRIX_SPACE_VOID}${lp_terminal_format}${sep}${DOTMATRIX_SPACE_VOID}"
+}
+
+__dotmatrix_make_sep_link() { # color
+    local lp_terminal_format
+    dotmatrix_sep=""
+
+    lp_terminal_format -3 -1 0 0 -1 "${6-}"
+    dotmatrix_sep+="${DOTMATRIX_SPACE_VOID}${lp_terminal_format}${DOTMATRIX_LINK[0]}"
+
+    lp_terminal_format 244 -1 0 0 -1 "${6-}"
+    dotmatrix_sep+="${lp_terminal_format}${DOTMATRIX_LINK[1]}"
+
+    lp_terminal_format "${2-}" -1 0 0 -1 "${6-}"
+    dotmatrix_sep+="${lp_terminal_format}${DOTMATRIX_LINK[2]}${DOTMATRIX_SPACE_FILL}"
+}
+
+__dotmatrix_make_sep_open() { # color
+    local lp_terminal_format
+
+    lp_terminal_format -3 -1 0 0 -1 "${6-}"
+    dotmatrix_sep+="${DOTMATRIX_SPACE_VOID}${lp_terminal_format}${DOTMATRIX_OPEN[0]}"
+
+    lp_terminal_format 244 -1 0 0 -1 "${6-}"
+    dotmatrix_sep+="${lp_terminal_format}${DOTMATRIX_OPEN[1]}"
+
+    lp_terminal_format "${2-}" -1 0 0 -1 "${6-}"
+    dotmatrix_sep+="${lp_terminal_format}${DOTMATRIX_OPEN[2]}${DOTMATRIX_SPACE_FILL}"
+}
+
+__dotmatrix_make_sep_dang() { # color
+    local lp_terminal_format
+
+    lp_terminal_format -3 -1 0 0 -1 "${6-}"
+    dotmatrix_sep+="${DOTMATRIX_SPACE_VOID}${lp_terminal_format}${DOTMATRIX_DANG[0]}"
+
+    lp_terminal_format 220 -1 0 0 -1 "${6-}"
+    dotmatrix_sep+="${lp_terminal_format}${DOTMATRIX_DANG[1]}"
+
+    lp_terminal_format "${2-}" -1 0 0 -1 "${6-}"
+    dotmatrix_sep+="${lp_terminal_format}${DOTMATRIX_DANG[2]}${DOTMATRIX_SPACE_FILL}"
+}
+
+__dotmatrix_make_sep_soft() { # color
+    local lp_terminal_format
+    lp_terminal_format "${1-}" -2 0 0 "${5-}"
+    dotmatrix_sep="${lp_terminal_format}${DOTMATRIX_SOFT}"
+}
+
+__dotmatrix_make_sep_mid() { # color
+    local lp_terminal_format
+    lp_terminal_format "${1-}" -2 0 0 "${5-}"
+    dotmatrix_sep="${lp_terminal_format}${DOTMATRIX_MEAN}"
+}
+
+__dotmatrix_make_sep_last() { # no arg
+    local lp_terminal_format
+    lp_terminal_format -3 -1 0 0 -3 -1
+    dotmatrix_sep="${lp_terminal_format}${DOTMATRIX_ENDS[0]}${NO_COL}"
+}
+
+__dotmatrix_make_sep_side() { # no arg
+    local lp_terminal_format
+    lp_terminal_format "${DOTMATRIX_COLOR_SEP_FAIR[@]}"
+    dotmatrix_sep="${lp_terminal_format}${DOTMATRIX_ENDS[1]}"
+}
+
diff --git a/themes/dotmatrix/liquidprompt_dotmatrix_design.odt b/themes/dotmatrix/liquidprompt_dotmatrix_design.odt
new file mode 100644
index 0000000000000000000000000000000000000000..fdbd497b0700ea94f5815525f6c20bdc01856cf0
GIT binary patch
literal 17088
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

literal 0
HcmV?d00001