#!/usr/bin/env bash
#
# Copyright 2026 Hunan Yijing Technologies Co., Ltd
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
# 📝 模块描述 : 视觉样式、排版与视觉交互组件
# 📁 文件路径 : lib/common.sh
# 👤 作者信息 : mingy
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


# ═══════════════════════════════════════════════════════════════
# 严格模式与初始化
# ═══════════════════════════════════════════════════════════════

set -euo pipefail

# ═══════════════════════════════════════════════════════════════
# ANSI终端颜色定义
# ═══════════════════════════════════════════════════════════════

declare -A COLORS=(
 [reset]=$'0円33[0m'
 [clear]=$'0円33[0m'

 [bold]=$'0円33[1m'
 [dim]=$'0円33[2m'
 [italic]=$'0円33[3m'
 [underline]=$'0円33[4m'
 [blink]=$'0円33[5m'
 [reverse]=$'0円33[7m'
 [hidden]=$'0円33[8m'
 [strike]=$'0円33[9m'

 [black]=$'0円33[30m'
 [red]=$'0円33[31m'
 [green]=$'0円33[32m'
 [yellow]=$'0円33[33m'
 [blue]=$'0円33[34m'
 [magenta]=$'0円33[35m'
 [cyan]=$'0円33[36m'
 [white]=$'0円33[37m'
 [gray]=$'0円33[90m'

 [bright_black]=$'0円33[90m'
 [bright_red]=$'0円33[91m'
 [bright_green]=$'0円33[92m'
 [bright_yellow]=$'0円33[93m'
 [bright_blue]=$'0円33[94m'
 [bright_magenta]=$'0円33[95m'
 [bright_cyan]=$'0円33[96m'
 [bright_white]=$'0円33[97m'

 [bg_black]=$'0円33[40m'
 [bg_red]=$'0円33[41m'
 [bg_green]=$'0円33[42m'
 [bg_yellow]=$'0円33[43m'
 [bg_blue]=$'0円33[44m'
 [bg_magenta]=$'0円33[45m'
 [bg_cyan]=$'0円33[46m'
 [bg_white]=$'0円33[47m'

 [bg_bright_black]=$'0円33[100m'
 [bg_bright_red]=$'0円33[101m'
 [bg_bright_green]=$'0円33[102m'
 [bg_bright_yellow]=$'0円33[103m'
 [bg_bright_blue]=$'0円33[104m'
 [bg_bright_magenta]=$'0円33[105m'
 [bg_bright_cyan]=$'0円33[106m'
 [bg_bright_white]=$'0円33[107m'
)

readonly RED="${COLORS[red]}"
readonly GREEN="${COLORS[green]}"
readonly YELLOW="${COLORS[yellow]}"
readonly BLUE="${COLORS[blue]}"
readonly MAGENTA="${COLORS[magenta]}"
readonly CYAN="${COLORS[cyan]}"
readonly WHITE="${COLORS[white]}"
readonly GRAY="${COLORS[gray]}"

readonly BRIGHT_RED="${COLORS[bright_red]}"
readonly BRIGHT_GREEN="${COLORS[bright_green]}"
readonly BRIGHT_YELLOW="${COLORS[bright_yellow]}"
readonly BRIGHT_BLUE="${COLORS[bright_blue]}"
readonly BRIGHT_MAGENTA="${COLORS[bright_magenta]}"
readonly BRIGHT_CYAN="${COLORS[bright_cyan]}"
readonly BRIGHT_WHITE="${COLORS[bright_white]}"

readonly NC="${COLORS[reset]}"
readonly BOLD="${COLORS[bold]}"

export GREEN RED YELLOW BLUE MAGENTA CYAN GRAY WHITE BRIGHT_RED BRIGHT_GREEN BRIGHT_YELLOW BRIGHT_BLUE BRIGHT_MAGENTA BRIGHT_CYAN BRIGHT_WHITE NC BOLD

# ═══════════════════════════════════════════════════════════════
# 状态消息输出
# ═══════════════════════════════════════════════════════════════

msg_info() { echo -e " ${BLUE}[INFO]${NC}1ドル" >&2; }
msg_error() { echo -e " ${RED}[FAIL]${NC}1ドル" >&2; }
msg_success() { echo -e " ${GREEN}[ OK ]${NC}1ドル" >&2; }
msg_warning() { echo -e " ${YELLOW}[WARN]${NC}1ドル" >&2; }
msg_question() { echo -e " [ ${MAGENTA}??${NC} ] 1ドル" >&2; }
msg_star() { echo -e " ${BRIGHT_YELLOW}*${NC}1ドル" >&2; }
msg_prompt() { 
 local prompt_text="1ドル"
 local target_var="${2:-choice}"
 local _input_val=""
 read -r -p " ${BRIGHT_MAGENTA}➤${NC}${BRIGHT_CYAN}${prompt_text}: ${NC}" _input_val
 printf -v "$target_var" "%s" "$_input_val"
}

msg_prompt_required() {
 local prompt_text="1ドル"
 local target_var="2ドル"
 local _res_val=""
 while true; do
msg_prompt "$prompt_text" _res_val
 if [[ -n "$_res_val" ]]; then
printf -v "$target_var" "%s" "$_res_val"
 return 0
 fi
msg_error "输入不能为空,请重新输入"
 done
}

# ═══════════════════════════════════════════════════════════════
# 命令状态检查
# ═══════════════════════════════════════════════════════════════

action() {
 local exit_code=$?
 if [[ $exit_code -eq 0 ]]; then
msg_success "1ドル"
 return 0
 else
msg_error "2ドル"
 return 1
 fi
}

# ═══════════════════════════════════════════════════════════════
# 排版与渲染工具
# ═══════════════════════════════════════════════════════════════

get_term_width() {
 local width
 width=$(tput cols 2>/dev/null) || width=80
 [[ $width -gt 100 ]] && width=100
 echo "$width"
}

draw_line() {
 local char="${1:--}"
 local color="${2:-}"

 local width
 width=$(get_term_width)
 local line_w=$((width - 6))
 [[ $line_w -gt 60 ]] && line_w=60
 [[ $line_w -lt 40 ]] && line_w=40
 
 {
 printf " "
 [[ -n "$color" ]] && printf "%b" "$color"
 local i
 for ((i=0; i<line_w; i++)); do printf "%s" "$char"; done
 [[ -n "$color" ]] && printf "%b" "${NC}"
 echo ""
 } >&2
}

str_display_width() {
 local str="1ドル"
 local pure_str
 pure_str=$(echo -e "$str" | sed 's/\x1b\[[0-9;]*m//g')
 echo -n "$pure_str" | wc -L
}

msg_table_row() {
 local -a widths
 read -ra widths <<< "1ドル"
 shift
 local table_cols=("$@")
 local row_str=" "
 local i

 for i in "${!table_cols[@]}"; do
local content="${table_cols[$i]}"
 local width="${widths[$i]:-0}"
 local d_w; d_w=$(str_display_width "$content")
 
 local padding=$((width - d_w))
 [[ $padding -lt 0 ]] && padding=0
 
 if [[ $i -eq $(( ${#table_cols[@]} - 1 )) ]]; then
row_str+="${content}"
 else
row_str+="${content}$(printf "%*s" "$padding" " ")"
 fi
 done
echo -e "$row_str"
}

# ═══════════════════════════════════════════════════════════════
# UI布局辅助
# ═══════════════════════════════════════════════════════════════

ui_set_borders() {
 local w=1ドル
 top_border="╭$(printf '─%.0s' $(seq 1 $((w - 2))))╮"
 mid_border="├$(printf '─%.0s' $(seq 1 $((w - 2))))┤"
 bottom_border="╰$(printf '─%.0s' $(seq 1 $((w - 2))))╯"
}

ui_print_centered_row() {
 local w=1ドル color="2ドル" text="3ドル"
 local tw; tw=$(str_display_width "$text")
 local lp=$(( (w - 2 - tw) / 2 ))
 local rp=$(( w - 2 - tw - lp ))
 echo -e " ${GREEN}│${NC}$(printf '%*s' "$lp" ' ')${color}${text}${NC}$(printf '%*s' "$rp" ' ')${GREEN}│${NC}"
}

ui_print_blank_row() {
 local w=1ドル
 echo -e " ${GREEN}│${NC}$(printf '%*s' $((w - 2)) ' ')${GREEN}│${NC}"
}

ui_print_footer() {
 local total_width=1ドル left_text="2ドル" right_text="3ドル"
 local left_color="${4:-$WHITE}" right_color="${5:-$BRIGHT_GREEN}"
 
 local left_w; left_w=$(str_display_width "$left_text")
 local right_w; right_w=$(str_display_width "$right_text")
 
 local padding=$((total_width - 6 - left_w - right_w))
 [[ $padding -lt 0 ]] && padding=0
 
 echo -e " ${GREEN}│${NC}${left_color}${left_text}${NC}$(printf '%*s' "$padding" ' ')${right_color}${right_text}${NC}${GREEN}│${NC}"
}

ui_render_grid() {
 local grid_cols=1ドル item_width=2ドル total_width=3ドル num_color=4ドル
 shift 4
 local grid_items=("$@")
 local count=${#grid_items[@]}
 local mid=$(( (count + grid_cols - 1) / grid_cols ))
 local r c
 
 for ((r=0; r<mid; r++)); do
local line="" pure_line=""
 for ((c=0; c<grid_cols; c++)); do
local idx=$((r + c*mid))
 if [[ $idx -lt $count ]]; then
local num=$((idx+1)) name="${grid_items[$idx]}"
 local num_fmt; num_fmt=$(printf "%2d" "$num")
 local item_str=" ${num_color}${num_fmt}.${NC}${name}"
 local pure_item=" ${num_fmt}. ${name}"
 
 local w; w=$(str_display_width "$pure_item")
 local pad=$((item_width - w))
 [[ $pad -lt 0 ]] && pad=0
 line+="${item_str}$(printf '%*s' "$pad" ' ')"
 pure_line+="${pure_item}$(printf '%*s' "$pad" ' ')"
 else
line+="$(printf '%*s' "$item_width" ' ')"
 pure_line+="$(printf '%*s' "$item_width" ' ')"
 fi
 done
local t_w; t_w=$(str_display_width "$pure_line")
 local p=$((total_width - 2 - t_w))
 [[ $p -lt 0 ]] && p=0
 echo -e " ${GREEN}│${NC}${line}$(printf '%*s' "$p" ' ')${GREEN}│${NC}"
 done
}

show_header() {
 local title="1ドル"
 local width="${2:-0}"
 local color="${3:-$GREEN}"
 
 local top_border bottom_border
 if [[ $width -gt 0 ]]; then
ui_set_borders "$width"
 echo ""
 echo -e " ${color}${top_border}${NC}"
 ui_print_centered_row "$width" "${BOLD}" "$title"
 echo -e " ${color}${bottom_border}${NC}"
 else
local tw; tw=$(str_display_width "$title")
 local border_w=$((tw + 4))
 local border; border=$(printf '─%.0s' $(seq 1 $border_w))
 echo ""
 echo -e " ${color}╭${border}╮${NC}"
 echo -e " ${color}│${NC}${BOLD}${title}${NC}${color}│${NC}"
 echo -e " ${color}╰${border}╯${NC}"
 fi
}

show_banner_rich() {
 local title="${1:-}"
 local desc1="${2:-}"
 local desc2="${3:-}"
 local author="${4:-}"
 local total_w="${5:-60}"
 local is_connector="${6:-0}"

 local top_border mid_border bottom_border
 ui_set_borders "$total_w"

 echo ""
 echo -e " ${GREEN}${top_border}${NC}"
 ui_print_blank_row "$total_w"
 [[ -n "$title" ]] && ui_print_centered_row "$total_w" "${BOLD}${BRIGHT_CYAN}" "$title"
 ui_print_blank_row "$total_w"
 [[ -n "$desc1" ]] && ui_print_centered_row "$total_w" "${BRIGHT_GREEN}" "$desc1"
 [[ -n "$desc2" ]] && ui_print_centered_row "$total_w" "${BRIGHT_GREEN}" "$desc2"
 ui_print_blank_row "$total_w"
 [[ -n "$author" ]] && ui_print_centered_row "$total_w" "${BRIGHT_YELLOW}" "$author"
 ui_print_blank_row "$total_w"
 
 if [[ "$is_connector" == "1" ]]; then
echo -e " ${GREEN}${mid_border}${NC}"
 else
echo -e " ${GREEN}${bottom_border}${NC}"
 fi
}

show_section() {
 local title="1ドル"
 local current="${2:-}"
 local total="${3:-}"
 
 local display_title="$title"
 if [[ -n "$current" && -n "$total" ]]; then
display_title="阶段 $current/$total: $title"
 fi

local width; width=$(get_term_width)
 local line_w=$((width - 6))
 [[ $line_w -gt 60 ]] && line_w=60
 [[ $line_w -lt 40 ]] && line_w=40
 
 local border; border=$(printf '─%.0s' $(seq 1 $line_w))
 {
 echo ""
 echo -e " ${BRIGHT_GREEN}▸ ${BOLD}${display_title}${NC}"
 echo -e " ${border}"
 } >&2
}


# ═══════════════════════════════════════════════════════════════
# 全局显示控制
# ═══════════════════════════════════════════════════════════════

clear_screen() {
 hash -r 2>/dev/null || true
clear 2>/dev/null || printf "0円33c" 2>/dev/null || true
}

pause() {
 local msg="${1:-按任意键继续...}"
 echo "" >&2
 read -r -n 1 -p " ${WHITE}${msg}${NC}"
 echo "" >&2
}

# ═══════════════════════════════════════════════════════════════
# 进度条渲染
# ═══════════════════════════════════════════════════════════════

show_progress() {
 local current=1ドル
 local total=2ドル
 local width=40
 [[ $total -eq 0 ]] && total=100
 [[ $current -gt $total ]] && current=$total
 local percentage=$((current * 100 / total))
 local filled=$((current * width / total))
 local empty=$((width - filled))
 printf "\r0円33[K [" >&2
 printf "%${filled}s" "" | tr " " "#" >&2
 printf "%${empty}s" "" | tr " " "-" >&2
 printf "] %3d%%" "$percentage" >&2
}