karnel-termux 0.0.1

package/karnel/tools/shell/zsh-completions/install.sh

@@ -0,0 +1,85 @@
+#!/usr/bin/env bash
+
+import "@/utils/log"
+
+LOG_FILE="$KARNEL_CACHE/install_shell.log"
+ZSH_PLUGINS_DIR="$HOME/.zsh-plugins"
+
+_zsh_completions_dependencies() {
+  declare -A DEPS=(
+    ["zsh"]="zsh"
+    ["zoxide"]="zoxide"
+    ["git"]="git"
+  )
+
+  local pkg_name bin_name
+  for pkg_name in "${!DEPS[@]}"; do
+    bin_name="${DEPS[$pkg_name]}"
+    if ! command -v "$bin_name" &>/dev/null; then
+      if ! pkg install "$pkg_name" -y &>>"$LOG_FILE"; then
+        log_error "Failed to install $pkg_name"
+        return 1
+      fi
+    fi
+  done
+
+  log_success "Shell dependencies installed"
+  return 0
+}
+
+_install_zsh_completions_git() {
+  loading "Installing zsh-completions" _install_zsh_completions_git_impl
+}
+
+_install_zsh_completions_git_impl() {
+  mkdir -p "$(dirname "$LOG_FILE")"
+  if ! git clone --depth=1 "https://github.com/zsh-users/zsh-completions.git" "$ZSH_PLUGINS_DIR/zsh-completions" &>>"$LOG_FILE"; then
+    log_error "Failed to install zsh-completions"
+    return 1
+  fi
+  return 0
+}
+
+install_zsh_completions() {
+  if [[ -d "$ZSH_PLUGINS_DIR/zsh-completions" ]]; then
+    log_info "zsh-completions already installed"
+    return 0
+  fi
+
+  _zsh_completions_dependencies
+
+  _install_zsh_completions_git || return 1
+  log_success "Installed"
+  return 0
+}
+
+_uninstall_zsh_completions_impl() {
+  if [[ ! -d "$ZSH_PLUGINS_DIR/zsh-completions" ]]; then
+    log_info "zsh-completions is not installed"
+    return 0
+  fi
+
+  rm -rf "$ZSH_PLUGINS_DIR/zsh-completions"
+}
+
+uninstall_zsh_completions() {
+  loading "Uninstalling zsh-completions" _uninstall_zsh_completions_impl
+}
+
+_update_zsh_completions_impl() {
+  if [[ ! -d "$ZSH_PLUGINS_DIR/zsh-completions/.git" ]]; then
+    log_warn "zsh-completions not installed"
+    return 0
+  fi
+
+  git -C "$ZSH_PLUGINS_DIR/zsh-completions" pull &>>"$LOG_FILE"
+}
+
+update_zsh_completions() {
+  loading "Updating zsh-completions" _update_zsh_completions_impl
+}
+
+reinstall_zsh_completions() {
+  uninstall_zsh_completions
+  install_zsh_completions
+}

package/karnel/tools/shell/zsh-defer/README.md

@@ -0,0 +1,43 @@
+# Zsh-defer
+
+Deferred plugin loading for faster ZSH startup
+
+**Package:** zsh-defer  
+**Author:** israel marques  
+**Repository:** https://github.com/israelmarques1024-dotcom/karnel-termux  
+**Official:** https://github.com/romkatv/zsh-defer  
+**Type:** ZSH plugin (git clone)  
+**License:** MIT
+
+## Description
+
+Zsh-defer defers the loading of ZSH plugins to after the first prompt, significantly improving shell startup time. Non-essential plugins are loaded in the background while the shell remains responsive.
+
+## Dependencies
+
+- ZSH, git, zoxide
+
+## Install
+
+```bash
+karnel install shell --zsh-defer
+```
+
+## Uninstall
+
+```bash
+karnel uninstall shell --zsh-defer
+```
+
+## Update
+
+```bash
+karnel update shell --zsh-defer
+```
+
+## Notes
+
+- Installed in `~/.zsh-plugins/`
+- Delays plugin loading until after first prompt
+- Improves perceived ZSH startup time
+

package/karnel/tools/shell/zsh-defer/install.sh

@@ -0,0 +1,85 @@
+#!/usr/bin/env bash
+
+import "@/utils/log"
+
+LOG_FILE="$KARNEL_CACHE/install_shell.log"
+ZSH_PLUGINS_DIR="$HOME/.zsh-plugins"
+
+_zsh_defer_dependencies() {
+  declare -A DEPS=(
+    ["zsh"]="zsh"
+    ["zoxide"]="zoxide"
+    ["git"]="git"
+  )
+
+  local pkg_name bin_name
+  for pkg_name in "${!DEPS[@]}"; do
+    bin_name="${DEPS[$pkg_name]}"
+    if ! command -v "$bin_name" &>/dev/null; then
+      if ! pkg install "$pkg_name" -y &>>"$LOG_FILE"; then
+        log_error "Failed to install $pkg_name"
+        return 1
+      fi
+    fi
+  done
+
+  log_success "Shell dependencies installed"
+  return 0
+}
+
+_install_zsh_defer_git() {
+  loading "Installing zsh-defer" _install_zsh_defer_git_impl
+}
+
+_install_zsh_defer_git_impl() {
+  mkdir -p "$(dirname "$LOG_FILE")"
+  if ! git clone --depth=1 "https://github.com/romkatv/zsh-defer.git" "$ZSH_PLUGINS_DIR/zsh-defer" &>>"$LOG_FILE"; then
+    log_error "Failed to install zsh-defer"
+    return 1
+  fi
+  return 0
+}
+
+install_zsh_defer() {
+  if [[ -d "$ZSH_PLUGINS_DIR/zsh-defer" ]]; then
+    log_info "zsh-defer already installed"
+    return 0
+  fi
+
+  _zsh_defer_dependencies
+
+  _install_zsh_defer_git || return 1
+  log_success "Installed"
+  return 0
+}
+
+_uninstall_zsh_defer_impl() {
+  if [[ ! -d "$ZSH_PLUGINS_DIR/zsh-defer" ]]; then
+    log_info "zsh-defer is not installed"
+    return 2
+  fi
+
+  rm -rf "$ZSH_PLUGINS_DIR/zsh-defer"
+}
+
+uninstall_zsh_defer() {
+  loading "Uninstalling zsh-defer" _uninstall_zsh_defer_impl
+}
+
+_update_zsh_defer_impl() {
+  if [[ ! -d "$ZSH_PLUGINS_DIR/zsh-defer/.git" ]]; then
+    log_warn "zsh-defer not installed"
+    return 0
+  fi
+
+  git -C "$ZSH_PLUGINS_DIR/zsh-defer" pull &>>"$LOG_FILE"
+}
+
+update_zsh_defer() {
+  loading "Updating zsh-defer" _update_zsh_defer_impl
+}
+
+reinstall_zsh_defer() {
+  uninstall_zsh_defer
+  install_zsh_defer
+}

package/karnel/tools/shell/zsh-syntax-highlighting/README.md

@@ -0,0 +1,43 @@
+# Zsh-syntax-highlighting
+
+Real-time syntax highlighting for ZSH commands
+
+**Package:** zsh-syntax-highlighting  
+**Author:** israel marques  
+**Repository:** https://github.com/israelmarques1024-dotcom/karnel-termux  
+**Official:** https://github.com/zsh-users/zsh-syntax-highlighting  
+**Type:** ZSH plugin (git clone)  
+**License:** BSD 3-Clause
+
+## Description
+
+Zsh-syntax-highlighting provides real-time syntax highlighting for commands as you type in ZSH. Valid commands are highlighted in green, invalid in red, and various tokens get different colors for better readability.
+
+## Dependencies
+
+- ZSH, git, zoxide
+
+## Install
+
+```bash
+karnel install shell --zsh-syntax-highlighting
+```
+
+## Uninstall
+
+```bash
+karnel uninstall shell --zsh-syntax-highlighting
+```
+
+## Update
+
+```bash
+karnel update shell --zsh-syntax-highlighting
+```
+
+## Notes
+
+- Installed in `~/.zsh-plugins/`
+- Highlights commands in real-time
+- Must be loaded last in plugin order
+

package/karnel/tools/shell/zsh-syntax-highlighting/install.sh

@@ -0,0 +1,72 @@
+#!/usr/bin/env bash
+
+import "@/utils/log"
+
+LOG_FILE="$KARNEL_CACHE/install_shell.log"
+ZSH_PLUGINS_DIR="$HOME/.zsh-plugins"
+
+_zsh_syntax_highlighting_dependencies() {
+  if command -v git &>/dev/null && command -v zsh &>/dev/null; then
+    return 0
+  fi
+
+  mkdir -p "$(dirname "$LOG_FILE")"
+  pkg install zsh zoxide git -y &>>"$LOG_FILE"
+}
+
+_install_zsh_syntax_highlighting_git() {
+  loading "Installing zsh-syntax-highlighting" _install_zsh_syntax_highlighting_git_impl
+}
+
+_install_zsh_syntax_highlighting_git_impl() {
+  mkdir -p "$(dirname "$LOG_FILE")"
+  if ! git clone --depth=1 "https://github.com/zsh-users/zsh-syntax-highlighting.git" "$ZSH_PLUGINS_DIR/zsh-syntax-highlighting" &>>"$LOG_FILE"; then
+    log_error "Failed to install zsh-syntax-highlighting"
+    return 1
+  fi
+  return 0
+}
+
+install_zsh_syntax_highlighting() {
+  if [[ -d "$ZSH_PLUGINS_DIR/zsh-syntax-highlighting" ]]; then
+    log_info "zsh-syntax-highlighting already installed"
+    return 0
+  fi
+
+  _zsh_syntax_highlighting_dependencies
+
+  _install_zsh_syntax_highlighting_git || return 1
+  log_success "Installed"
+  return 0
+}
+
+_uninstall_zsh_syntax_highlighting_impl() {
+  if [[ ! -d "$ZSH_PLUGINS_DIR/zsh-syntax-highlighting" ]]; then
+    log_info "zsh-syntax-highlighting is not installed"
+    return 0
+  fi
+
+  rm -rf "$ZSH_PLUGINS_DIR/zsh-syntax-highlighting"
+}
+
+uninstall_zsh_syntax_highlighting() {
+  loading "Uninstalling zsh-syntax-highlighting" _uninstall_zsh_syntax_highlighting_impl
+}
+
+_update_zsh_syntax_highlighting_impl() {
+  if [[ ! -d "$ZSH_PLUGINS_DIR/zsh-syntax-highlighting/.git" ]]; then
+    log_warn "zsh-syntax-highlighting not installed"
+    return 0
+  fi
+
+  git -C "$ZSH_PLUGINS_DIR/zsh-syntax-highlighting" pull &>>"$LOG_FILE"
+}
+
+update_zsh_syntax_highlighting() {
+  loading "Updating zsh-syntax-highlighting" _update_zsh_syntax_highlighting_impl
+}
+
+reinstall_zsh_syntax_highlighting() {
+  uninstall_zsh_syntax_highlighting
+  install_zsh_syntax_highlighting
+}

package/karnel/tools/ui/all.sh

@@ -0,0 +1,61 @@
+#!/usr/bin/env bash
+
+import "@/utils/log"
+
+LOG_FILE="$KARNEL_CACHE/install_ui.log"
+TERMUX_DIR="$HOME/.termux"
+
+UI_COMPONENTS=(
+  "font"
+  "extra-keys"
+  "cursor"
+  "banner"
+)
+
+for _tool in "${UI_COMPONENTS[@]}"; do
+  source "$(dirname "$BASH_SOURCE")/$_tool/install.sh"
+done
+unset _tool
+
+_batch_ui() {
+  local action="$1"
+  local action_past="$2"
+  local count_var="$3"
+  local count=0
+  local failed=0
+  local total=${#UI_COMPONENTS[@]}
+  local current=0
+  local func_name
+
+  progress_start "$total" "${action_past}ing UI components..."
+
+  for tool in "${UI_COMPONENTS[@]}"; do
+    func_name="${action}_${tool//-/_}"
+    if declare -f "$func_name" &>/dev/null; then
+      loading "${action_past^}ing ${tool}" "$func_name"
+      case $? in 0) ((count++));; 1) ((failed++));; esac
+    fi
+    ((current++))
+    progress_update "$current" "$total"
+  done
+
+  progress_done "$total"
+  eval "$count_var=$count"
+  return $failed
+}
+
+install_all_ui_components() {
+  _batch_ui "install" "install" "installed_count"
+}
+
+uninstall_all_ui_components() {
+  _batch_ui "uninstall" "uninstall" "uninstalled_count"
+}
+
+update_all_ui_components() {
+  _batch_ui "update" "update" "updated_count"
+}
+
+reinstall_all_ui_components() {
+  _batch_ui "reinstall" "reinstall" "reinstalled_count"
+}

package/karnel/tools/ui/banner/README.md

@@ -0,0 +1,42 @@
+# Banner Configuration for Termux
+
+Customize Termux with Karnel Termux Banner
+
+**Package:** karnel-termux (banner config)  
+**Author:** israel marques  
+**Repository:** https://github.com/israelmarques1024-dotcom/karnel-termux  
+**Type:** Termux UI customization  
+**License:** MIT
+
+## Description
+
+Configure a custom banner for Termux using Karnel Termux. This package allows you to set a personalized welcome message that appears when you start Termux, enhancing your terminal experience.
+
+## Dependencies
+
+- Termux (base installation)
+
+## Install
+
+```bash
+karnel install ui --banner
+```
+
+## Uninstall
+
+```bash
+karnel uninstall ui --banner
+```
+
+## Update
+
+```bash
+karnel update ui --banner
+```
+
+## Notes
+
+- Source file: `~/.local/share/karnel/assets/banner/karnel.txt`
+- removes Termux welcome message: motd
+- Restart Termux to apply changes
+

package/karnel/tools/ui/banner/install.sh

@@ -0,0 +1,160 @@
+#!/usr/bin/env bash
+
+import "@/utils/log"
+
+LOG_FILE="$KARNEL_CACHE/install_ui.log"
+
+KARNEL_BANNER_MARKER="# ===== Karnel Banner ====="
+KARNEL_MOTD_BACKUP="$KARNEL_CACHE/motd.backup"
+
+_backup_motd() {
+	if [[ ! -e "$PREFIX/etc/motd" ]]; then
+		return 0
+	fi
+
+	if [[ -e "$KARNEL_MOTD_BACKUP" ]]; then
+		log_info "Termux MOTD already backed up"
+		return 0
+	fi
+
+	log_info "Backing up Termux MOTD..."
+	mv "$PREFIX/etc/motd" "$KARNEL_MOTD_BACKUP"
+	log_success "Termux MOTD backed up to $KARNEL_MOTD_BACKUP"
+}
+
+_restore_motd() {
+	if [[ ! -e "$KARNEL_MOTD_BACKUP" ]]; then
+		return 0
+	fi
+
+	if [[ -e "$PREFIX/etc/motd" ]]; then
+		log_warn "Termux MOTD already exists, skipping restore"
+		return 0
+	fi
+
+	log_info "Restoring Termux MOTD..."
+	mv "$KARNEL_MOTD_BACKUP" "$PREFIX/etc/motd"
+	log_success "Termux MOTD restored"
+}
+
+_detect_shell_config() {
+	if [[ -f "$HOME/.zshrc" ]]; then
+		echo "$HOME/.zshrc"
+	elif [[ -f "$HOME/.bashrc" ]]; then
+		echo "$HOME/.bashrc"
+	fi
+}
+
+_install_banner_impl() {
+	local shell_config
+	shell_config="$(_detect_shell_config)"
+
+	if [[ -z "$shell_config" ]]; then
+		log_warn "No shell config file found (.zshrc or .bashrc)"
+		return 1
+	fi
+
+	if grep -qF "$KARNEL_BANNER_MARKER" "$shell_config" 2>/dev/null; then
+		log_info "Karnel Banner already installed"
+		return 0
+	fi
+
+	local banner_script="$KARNEL_UTILS/banner.sh"
+	if [[ ! -f "$banner_script" ]]; then
+		log_error "Banner script not found: $banner_script"
+		return 1
+	fi
+
+	mkdir -p "$(dirname "$LOG_FILE")"
+
+	cat >>"$shell_config" <<EOF
+
+$KARNEL_BANNER_MARKER
+source "$banner_script"
+
+clear() {
+	builtin clear 2>/dev/null || /usr/bin/clear 2>/dev/null || clear
+	local _banner_cache="\${XDG_CACHE_HOME:-$HOME/.cache}/karnel/banner_cache"
+	if [[ -f "$_banner_cache" ]]; then
+		cat "$_banner_cache"
+	fi
+}
+export -f clear 2>/dev/null
+EOF
+
+	log_success "Karnel Banner installed"
+
+	_backup_motd
+
+	log_warn "Restart Termux or run: source $shell_config"
+	return 0
+}
+
+install_banner() {
+	if grep -qF "$KARNEL_BANNER_MARKER" "$(_detect_shell_config)" 2>/dev/null; then
+		log_info "Karnel Banner already installed"
+		return 0
+	fi
+	log_info "Installing Karnel Banner..."
+	mkdir -p "$(dirname "$LOG_FILE")"
+	loading "Installing Banner" _install_banner_impl
+}
+
+_uninstall_banner_impl() {
+	local shell_config
+	shell_config="$(_detect_shell_config)"
+
+	if [[ -z "$shell_config" ]]; then
+		log_warn "No shell config file found"
+		return 1
+	fi
+
+	if ! grep -qF "$KARNEL_BANNER_MARKER" "$shell_config" 2>/dev/null; then
+		log_warn "Karnel Banner not installed"
+		return 0
+	fi
+
+	local marker_line
+	marker_line="$(grep -nF "$KARNEL_BANNER_MARKER" "$shell_config" | head -1 | cut -d: -f1)"
+
+	if [[ -n "$marker_line" ]]; then
+		local prev_line=$((marker_line - 1))
+		if sed -n "${prev_line}p" "$shell_config" 2>/dev/null | grep -q '^$'; then
+			sed -i "$((prev_line)),$((marker_line + 1))d" "$shell_config"
+		else
+			sed -i "$marker_line,$((marker_line + 1))d" "$shell_config"
+		fi
+		log_success "Karnel Banner uninstalled"
+	else
+		log_warn "Could not locate banner marker for removal"
+		return 1
+	fi
+
+	_restore_motd
+
+	return 0
+}
+
+uninstall_banner() {
+	if ! grep -qF "$KARNEL_BANNER_MARKER" "$(_detect_shell_config)" 2>/dev/null; then
+		log_warn "Karnel Banner not installed"
+		return 0
+	fi
+	log_info "Uninstalling Karnel Banner..."
+	loading "Uninstalling Banner" _uninstall_banner_impl
+}
+
+_update_banner_impl() {
+	uninstall_banner
+	install_banner
+}
+
+update_banner() {
+	log_info "Updating Karnel Banner..."
+	loading "Updating Banner" _update_banner_impl
+}
+
+reinstall_banner() {
+	uninstall_banner
+	install_banner
+}

package/karnel/tools/ui/cursor/README.md

@@ -0,0 +1,42 @@
+# Cursor Color
+
+Customize Termux terminal cursor color
+
+**Package:** karnel-termux (cursor config)  
+**Author:** israel marques  
+**Repository:** https://github.com/israelmarques1024-dotcom/karnel-termux  
+**Type:** Termux UI customization  
+**License:** MIT
+
+## Description
+
+Configures the Termux terminal cursor color to a custom value (default: green #00FF00). This provides better cursor visibility and personalization of the Termux terminal appearance.
+
+## Dependencies
+
+- Termux (base installation)
+
+## Install
+
+```bash
+karnel install ui --cursor
+```
+
+## Uninstall
+
+```bash
+karnel uninstall ui --cursor
+```
+
+## Update
+
+```bash
+karnel update ui --cursor
+```
+
+## Notes
+
+- Config file: `~/.termux/colors.properties`
+- Default cursor color: green (#00FF00)
+- Restart Termux to apply changes
+

package/karnel/tools/ui/cursor/install.sh

@@ -0,0 +1,58 @@
+#!/usr/bin/env bash
+
+import "@/utils/log"
+
+LOG_FILE="$KARNEL_CACHE/install_ui.log"
+TERMUX_DIR="$HOME/.termux"
+
+_install_cursor_impl() {
+	mkdir -p "$(dirname "$LOG_FILE")" "$TERMUX_DIR"
+
+	cat >"$TERMUX_DIR/colors.properties" <<'EOF'
+cursor=#00FF00
+EOF
+
+	log_success "Cursor color set to #00FF00 (green)"
+	return 0
+}
+
+install_cursor() {
+	if [[ -f "$TERMUX_DIR/colors.properties" ]]; then
+		log_info "Cursor Color already configured"
+		return 0
+	fi
+	log_info "Installing Cursor Color..."
+	loading "Installing Cursor Color" _install_cursor_impl
+}
+
+_uninstall_cursor_impl() {
+	if [[ -f "$TERMUX_DIR/colors.properties" ]]; then
+		rm "$TERMUX_DIR/colors.properties"
+		log_success "Cursor Color uninstalled"
+	else
+		log_warn "Cursor Color not configured"
+	fi
+}
+
+uninstall_cursor() {
+	if [[ ! -f "$TERMUX_DIR/colors.properties" ]]; then
+		log_info "Cursor Color is not installed"
+		return 0
+	fi
+	log_info "Uninstalling Cursor Color..."
+	loading "Uninstalling Cursor Color" _uninstall_cursor_impl
+}
+
+_update_cursor_impl() {
+	install_cursor
+}
+
+update_cursor() {
+	log_info "Updating Cursor Color..."
+	loading "Updating Cursor Color" _update_cursor_impl
+}
+
+reinstall_cursor() {
+	uninstall_cursor
+	install_cursor
+}