Add upclear utility

Makefile

@@ -27,14 +27,15 @@ demo: build
 
 $(OUTPUT): $(ALL_SRC_FILES)
 	@mkdir -p $(OUT_DIR)
-	@echo '#! /usr/bin/env bash' > $(OUTPUT)
+	@echo '#!/usr/bin/env bash' > $(OUTPUT)
 	@echo '# shellcheck disable=all' >> $(OUTPUT)
 	@echo '#' >> $(OUTPUT)
 	@echo '# beddu.sh - A lightweight bash framework for interactive scripts and pretty output' >> $(OUTPUT)
 	@echo '# https://github.com/mjsarfatti/beddu' >> $(OUTPUT)
 	@echo '#' >> $(OUTPUT)
+	@echo '# Version: $(shell git describe --tags --dirty)' >> $(OUTPUT)
 	@echo '# Generated on: $(shell date)' >> $(OUTPUT)
-	@# Process each file, stripping (line) comments and empty lines
+	@# Process each file, stripping comments and empty lines
 	@for file in $(ALL_SRC_FILES); do \
 		echo "" >> $(OUTPUT); \
 		grep -v '^\s*#' "$$file" | sed '/^[[:space:]]*$$/d' | sed 's/#[a-zA-Z0-9 ]*$$//' >> $(OUTPUT); \

build/beddu.sh

@@ -1,19 +1,20 @@
-#! /usr/bin/env bash
+#!/usr/bin/env bash
 # shellcheck disable=all
 #
 # beddu.sh - A lightweight bash framework for interactive scripts and pretty output
 # https://github.com/mjsarfatti/beddu
 #
-# Generated on: Fri May  9 20:00:08 CEST 2025
+# Version: v0.0.3-dirty
+# Generated on: Sun May 11 01:40:08 CEST 2025
 
-_q='?'
+readonly _q='?'
-_a='❯'
+readonly _a='❯'
-_o='◌'
+readonly _o='◌'
-_O='●'
+readonly _O='●'
-_mark='✓'
+readonly _mark='✓'
-_warn='!'
+readonly _warn='!'
-_cross='✗'
+readonly _cross='✗'
-_spinner='⣷⣯⣟⡿⢿⣻⣽⣾' # See for alternatives: https://antofthy.gitlab.io/info/ascii/Spinners.txt
+readonly _spinner='⣷⣯⣟⡿⢿⣻⣽⣾' # See for alternatives: https://antofthy.gitlab.io/info/ascii/Spinners.txt
 export _q _a _o _O _mark _warn _cross _spinner
 
 up() {
@@ -32,9 +33,7 @@ cl() {
     printf "\033[2K"
 }
 upclear() {
-    up
+    up; bol; cl
-    bol
-    cl
 }
 line() {
     printf "\n"
@@ -118,9 +117,7 @@ export -f run
 check() {
     if spinning; then
         spop
-        up
+        upclear
-        bol
-        cl
     fi
     pen -n green "${_mark:-✓} "
     pen "$@"
@@ -183,9 +180,7 @@ export -f spin spop spinning
 throw() {
     if spinning; then
         spop
-        up
+        upclear
-        bol
-        cl
     fi
     pen -n red "${_cross:-✗} "
     pen "$@"
@@ -195,9 +190,7 @@ export -f throw
 warn() {
     if spinning; then
         spop
-        up
+        upclear
-        bol
-        cl
     fi
     pen -n yellow bold italic "${_warn:-!} "
     pen italic "$@"

src/00.utils/_symbols.sh

@@ -1,13 +1,13 @@
-#! /usr/bin/env bash
+#!/usr/bin/env bash
 # @private
 
-_q='?'
+readonly _q='?'
-_a='❯'
+readonly _a='❯'
-_o='◌'
+readonly _o='◌'
-_O='●'
+readonly _O='●'
-_mark='✓'
+readonly _mark='✓'
-_warn='!'
+readonly _warn='!'
-_cross='✗'
+readonly _cross='✗'
-_spinner='⣷⣯⣟⡿⢿⣻⣽⣾' # See for alternatives: https://antofthy.gitlab.io/info/ascii/Spinners.txt
+readonly _spinner='⣷⣯⣟⡿⢿⣻⣽⣾' # See for alternatives: https://antofthy.gitlab.io/info/ascii/Spinners.txt
 
 export _q _a _o _O _mark _warn _cross _spinner

src/00.utils/movements.sh

@@ -1,4 +1,4 @@
-#! /usr/bin/env bash
+#!/usr/bin/env bash
 # movements.sh - Cursor helper functions
 
 # Move cursor up one line
@@ -28,9 +28,7 @@ cl() {
 
 # Clear line above
 upclear() {
-    up
+    up; bol; cl
-    bol
-    cl
 }
 
 # Print a single newline

src/01.core/pen.sh

@@ -1,4 +1,4 @@
-#! /usr/bin/env bash
+#!/usr/bin/env bash
 # pen.sh - Print pretty text
 
 # @depends on:

src/01.core/run.sh

@@ -1,4 +1,4 @@
-#! /usr/bin/env bash
+#!/usr/bin/env bash
 # run.sh - Execute commands with output/error capture
 
 # Execute a command with stdout and stderr capture capabilities

src/02.ui/check.sh

@@ -1,4 +1,4 @@
-#! /usr/bin/env bash
+#!/usr/bin/env bash
 # check.sh - Print a success message
 
 # @depends on:
@@ -25,9 +25,7 @@ check() {
     # If there is a spinner running, stop it and clear the line
     if spinning; then
         spop
-        up
+        upclear
-        bol
-        cl
     fi
 
     pen -n green "${_mark:-✓} "

src/02.ui/repen.sh

@@ -1,4 +1,4 @@
-#! /usr/bin/env bash
+#!/usr/bin/env bash
 # repen.sh - Overwrite the previous line with new text
 
 # @depends on:

src/02.ui/spin.sh

@@ -1,4 +1,4 @@
-#! /usr/bin/env bash
+#!/usr/bin/env bash
 # spin.sh - Print a spinner with a message
 
 # @depends on:

src/02.ui/throw.sh

@@ -1,4 +1,4 @@
-#! /usr/bin/env bash
+#!/usr/bin/env bash
 # throw.sh - Print an throw message
 
 # @depends on:
@@ -25,9 +25,7 @@ throw() {
     # If there is a spinner running, stop it and clear the line
     if spinning; then
         spop
-        up
+        upclear
-        bol
-        cl
     fi
 
     pen -n red "${_cross:-✗} "

src/02.ui/warn.sh

@@ -1,4 +1,4 @@
-#! /usr/bin/env bash
+#!/usr/bin/env bash
 # warn.sh - Print a warning message
 
 # @depends on:
@@ -25,9 +25,7 @@ warn() {
     # If there is a spinner running, stop it and clear the line
     if spinning; then
         spop
-        up
+        upclear
-        bol
-        cl
     fi
 
     pen -n yellow bold italic "${_warn:-!} "

src/03.prompt/ask.sh

@@ -1,4 +1,4 @@
-#! /usr/bin/env bash
+#!/usr/bin/env bash
 # ask.sh - Get free text input from the user
 
 # @depends on:

src/03.prompt/choose.sh

@@ -1,4 +1,4 @@
-#! /usr/bin/env bash
+#!/usr/bin/env bash
 # choose.sh - Choose from a menu of options
 
 # @depends on:

src/03.prompt/confirm.sh

@@ -1,4 +1,4 @@
-#! /usr/bin/env bash
+#!/usr/bin/env bash
 # confirm.sh - Read a yes/no confirmation from the user
 
 # @depends on: