lx

#!/usr/bin/env bash
#
#  lx — gerenciador único do projeto linux-android
#
#  Autor:    Nicolas Arthur  (https://github.com/NicolasArthurDev)
#  Projeto:  https://github.com/NicolasArthurDev/linux-android
#  Licença:  MIT
#
#  Um script para tudo: instalar, iniciar, parar, diagnosticar e configurar
#  o ambiente Linux com KDE no Android, e o ambiente de desenvolvimento.
#
#  Uso:
#      ./lx                 menu interativo
#      ./lx <comando>       execução direta
#      ./lx help            lista os comandos
#
#  O script se adapta ao lugar onde está rodando (Termux ou dentro do Ubuntu)
#  e, quando precisa, se copia para dentro do Ubuntu e se re-invoca lá.
#
#  Se o shebang falhar no Termux, rode como:  bash lx <comando>
#
set -uo pipefail

readonly LX_VERSION="1.0.0"
readonly LX_AUTHOR="Nicolas Arthur"
readonly REPO_URL="https://github.com/NicolasArthurDev/linux-android"
readonly DISTRO="ubuntu"
readonly DISPLAY_NUM=":0"

# Versões fixadas onde o repositório da distro não serve (ver comentários no uso)
readonly MESA_REPO="lfdevs/mesa-for-android-container"

# ===========================================================================
#  Contexto: onde estamos rodando?
# ===========================================================================

detect_context() {
    if [ -n "${PREFIX:-}" ] && [ -d "/data/data/com.termux/files/usr" ]; then
        echo "termux"
    elif [ -f /etc/os-release ] && grep -qi ubuntu /etc/os-release; then
        echo "ubuntu"
    else
        echo "desconhecido"
    fi
}

readonly CTX="$(detect_context)"

# ---------------------------------------------------------------------------
#  Onde o proot-distro guarda o rootfs
#
#  O layout MUDOU quando o proot-distro foi reescrito em Python (v5, 2026):
#
#      v5+     <PREFIX>/var/lib/proot-distro/containers/<nome>/rootfs
#      legado  <PREFIX>/var/lib/proot-distro/installed-rootfs/<nome>
#
#  Assumir só o caminho legado fazia o script instalar o Ubuntu com sucesso e,
#  na linha seguinte, jurar que ele não estava instalado. Procuramos os dois.
#
#  É função (e não constante) porque o diretório passa a existir no meio da
#  execução, logo após o 'proot-distro install'.
# ---------------------------------------------------------------------------
resolve_rootfs() {
    if [ "$CTX" != "termux" ]; then ROOTFS=""; return 0; fi
    local base="${PREFIX}/var/lib/proot-distro"
    local atual="${base}/containers/${DISTRO}/rootfs"
    local legado="${base}/installed-rootfs/${DISTRO}"
    if   [ -d "$atual" ];  then ROOTFS="$atual"
    elif [ -d "$legado" ]; then ROOTFS="$legado"
    else                        ROOTFS="$atual"   # ainda não instalado
    fi
}

ROOTFS=""
resolve_rootfs

if [ "$CTX" = "termux" ]; then
    STATE_DIR="${LX_STATE_DIR:-${PREFIX}/var/lib/lx}"
else
    STATE_DIR="${LX_STATE_DIR:-/var/lib/lx}"
fi
STATE_FILE="${STATE_DIR}/state"

# ===========================================================================
#  Saída na tela
# ===========================================================================

if [ -t 1 ] && [ "${NO_COLOR:-}" = "" ]; then
    C_RESET=$'\033[0m'; C_BOLD=$'\033[1m'; C_DIM=$'\033[2m'
    C_RED=$'\033[31m';  C_GRN=$'\033[32m'; C_YEL=$'\033[33m'
    C_BLU=$'\033[34m';  C_CYN=$'\033[36m'
else
    C_RESET=""; C_BOLD=""; C_DIM=""
    C_RED=""; C_GRN=""; C_YEL=""; C_BLU=""; C_CYN=""
fi

say()   { printf '%s\n' "$*"; }
step()  { printf '%s==>%s %s\n' "$C_BLU$C_BOLD" "$C_RESET" "$*"; }
ok()    { printf '%s  ok%s %s\n' "$C_GRN" "$C_RESET" "$*"; }
warn()  { printf '%s  !!%s %s\n' "$C_YEL" "$C_RESET" "$*" >&2; }
err()   { printf '%s ERRO%s %s\n' "$C_RED$C_BOLD" "$C_RESET" "$*" >&2; }
info()  { printf '%s     %s%s\n' "$C_DIM" "$*" "$C_RESET"; }
die()   { err "$*"; exit 1; }

header() {
    printf '\n%s%s%s\n' "$C_BOLD$C_CYN" "$*" "$C_RESET"
    printf '%s%s%s\n' "$C_DIM" "$(printf '─%.0s' $(seq 1 ${#1}))" "$C_RESET"
}

confirm() {
    local prompt="${1:-Continuar?}" reply
    if [ ! -t 0 ]; then return 0; fi   # não-interativo: assume sim
    printf '%s%s%s [s/N] ' "$C_BOLD" "$prompt" "$C_RESET"
    read -r reply
    case "$reply" in [sSyY]*) return 0 ;; *) return 1 ;; esac
}

# ===========================================================================
#  Estado — o que já foi feito
# ===========================================================================

state_init() { mkdir -p "$STATE_DIR" 2>/dev/null || true; touch "$STATE_FILE" 2>/dev/null || true; }
state_has()  { [ -f "$STATE_FILE" ] && grep -qxF "$1" "$STATE_FILE" 2>/dev/null; }

# O estado é conveniência, não fonte da verdade: 'setup' e 'doctor' checam o
# sistema de verdade (diretórios, binários). Se não der para gravar, seguimos
# em silêncio em vez de poluir a saída com erros.
state_set()  {
    state_init
    state_has "$1" && return 0
    echo "$1" >> "$STATE_FILE" 2>/dev/null || true
}
state_clear(){
    state_init
    [ -f "$STATE_FILE" ] || return 0
    grep -vxF "$1" "$STATE_FILE" > "$STATE_FILE.tmp" 2>/dev/null || true
    mv -f "$STATE_FILE.tmp" "$STATE_FILE" 2>/dev/null || rm -f "$STATE_FILE.tmp" 2>/dev/null || true
}

# ---------------------------------------------------------------------------
#  Ambiente padrao (qual desktop o 'lx start' sobe sem argumentos)
#
#  Precedencia: --de na linha de comando  >  $LX_DE  >  padrao salvo  >  kde
#
#  Guardamos num arquivo separado, e nao no state, porque o state registra
#  "o que ja foi feito" e e descartavel; isto e preferencia do usuario.
# ---------------------------------------------------------------------------
DE_FILE="${STATE_DIR}/default-de"

read_default_de() {
    local d
    d="$(cat "$DE_FILE" 2>/dev/null)"
    case "$d" in
        kde|bspwm|xfce) printf '%s' "$d" ;;
        *)              printf 'kde' ;;
    esac
}

# ===========================================================================
#  Utilidades
# ===========================================================================

have() { command -v "$1" >/dev/null 2>&1; }

# Caminho real deste arquivo, resolvendo symlinks.
#
# Importante porque, depois de 'lx install', o script é chamado através de um
# symlink em $PREFIX/bin. Sem resolver, qualquer coisa relativa ao repositório
# (docs, git pull) apontaria para o lugar errado.
self_path() {
    local s="${BASH_SOURCE[0]}"
    if have readlink; then
        readlink -f "$s" 2>/dev/null || printf '%s' "$s"
    else
        # Fallback sem readlink -f: segue a cadeia de symlinks à mão.
        while [ -L "$s" ]; do
            local dir; dir="$(cd -P "$(dirname "$s")" && pwd)"
            s="$(ls -ld "$s" | sed 's/.*-> //')"
            case "$s" in /*) ;; *) s="$dir/$s" ;; esac
        done
        printf '%s' "$s"
    fi
}

# Diretório do repositório (onde o lx de verdade mora).
repo_dir() { dirname "$(self_path)"; }

# Onde instalar o symlink, conforme o contexto.
link_target() {
    if [ "$CTX" = "termux" ]; then printf '%s/bin/lx' "$PREFIX"
    else printf '/usr/local/bin/lx'; fi
}

require_termux() {
    [ "$CTX" = "termux" ] || die "'$1' precisa rodar no Termux (contexto atual: $CTX)."
}

require_ubuntu_installed() {
    resolve_rootfs
    [ -d "$ROOTFS" ] || die "Ubuntu não está instalado. Rode primeiro: ./lx setup"
}

# Copia este script para dentro do Ubuntu e o executa lá.
run_in_ubuntu() {
    require_termux "run_in_ubuntu"
    require_ubuntu_installed
    local self; self="$(self_path)"
    [ -f "$self" ] || die "não consegui localizar o próprio script para copiar."
    install -m 755 "$self" "${ROOTFS}/root/lx" \
        || die "não consegui copiar o lx para dentro do Ubuntu."
    # Repassa o fuso do Android: o proot-distro sanitiza o ambiente, então
    # exportar aqui fora não bastaria.
    local tz; tz="$(getprop persist.sys.timezone 2>/dev/null)"
    proot-distro login "$DISTRO" --shared-tmp -- \
        /bin/bash -c "export LX_TZ=$(printf '%q' "${tz:-}"); exec /root/lx $*"
}

# Baixa uma URL para um arquivo. Usa curl ou wget, o que existir.
fetch() {
    local url="$1" out="$2"
    if have curl; then
        curl -fL --progress-bar -o "$out" "$url"
    elif have wget; then
        wget -q --show-progress -O "$out" "$url"
    else
        die "preciso de 'curl' ou 'wget' para baixar arquivos."
    fi
}

# Descobre a URL de um asset no release mais recente de um repo do GitHub.
gh_latest_asset() {
    local repo="$1" pattern="$2" api="https://api.github.com/repos/$1/releases/latest"
    local body
    if have curl;   then body="$(curl -fsSL "$api")"
    elif have wget; then body="$(wget -qO- "$api")"
    else return 1; fi
    printf '%s' "$body" | grep -o "https://[^\"]*${pattern}" | head -n 1
}

# Instala pacotes tolerando nomes que nao existem.
#
# POR QUE: 'apt install a b c' e tudo-ou-nada. Se UM nome nao existir, o apt
# aborta e nao instala NENHUM dos outros. Um unico erro de digitacao derruba a
# instalacao inteira — foi exatamente o que aconteceu com 'xsetroot' (que nao e
# pacote: o binario vem dentro de x11-xserver-utils), levando junto o bspwm.
#
# Estrategia: tenta o lote (rapido); se falhar, cai para um a um e reporta o
# que ficou de fora, em vez de perder tudo.
apt_install_soft() {
    apt install -y "$@" && return 0
    warn "instalação em lote falhou — tentando pacote a pacote"
    local pkg falhas=""
    for pkg in "$@"; do
        apt install -y "$pkg" >/dev/null 2>&1 || falhas="${falhas} ${pkg}"
    done
    [ -n "$falhas" ] && warn "não instalados:${falhas}"
    return 0
}

# Mesma ideia no lado do Termux.
pkg_install_soft() {
    pkg install -y "$@" && return 0
    warn "instalação em lote falhou — tentando pacote a pacote"
    local pkg falhas=""
    for pkg in "$@"; do
        pkg install -y "$pkg" >/dev/null 2>&1 || falhas="${falhas} ${pkg}"
    done
    [ -n "$falhas" ] && warn "não instalados:${falhas}"
    return 0
}

# ===========================================================================
#  Verificações do lado Android (não dá para automatizar — só detectar/guiar)
# ===========================================================================

# Deteccao de apps instalados no Android.
#
# CUIDADO: desde o Android 11 existe filtragem de visibilidade de pacotes. Um
# app so enxerga os outros que declara em <queries> ou com QUERY_ALL_PACKAGES.
# O 'pm list packages' rodado pelo Termux devolve uma lista FILTRADA, entao
# "nao apareceu" nao significa "nao instalado".
#
# Retorno: 0 = encontrado, 1 = nao encontrado, 2 = nao foi possivel verificar.
check_android_app() {
    local pkg="$1" out
    out="$(pm list packages 2>/dev/null)"
    if [ -z "$out" ]; then
        return 2                      # pm nao respondeu: sem informacao
    fi
    if printf '%s' "$out" | grep -q "^package:${pkg}$"; then
        return 0
    fi
    # A lista veio, mas sem o pacote. Pode ser ausencia real ou filtragem.
    # 'pm path' as vezes responde mesmo quando o list nao mostra.
    if pm path "$pkg" >/dev/null 2>&1; then
        return 0
    fi
    return 2
}

# Estado da restricao de processos filhos (Phantom Process Killer).
#
# Nao da para saber isto com certeza a partir do Termux:
#
#   - 'settings get global settings_enable_monitor_phantom_procs' e a chave
#     correta, mas so retorna "false" se a opcao foi gravada por ali. Em
#     varias ROMs (One UI incluida) o toggle das Opcoes de desenvolvedor grava
#     em outro lugar, e a leitura devolve "null" mesmo com a opcao ligada.
#
#   - 'device_config get activity_manager max_phantom_processes' exige root ou
#     ADB no Android 14+; do Termux da permission denied.
#
# Por isso distinguimos "desativada" de "nao sei", em vez de tratar as duas
# como problema. Acusar erro a quem ja fez a configuracao certa e pior do que
# admitir que a checagem nao alcanca.
#
# Retorno: 0 = desativada (bom), 1 = ativa, 2 = indeterminado.
PHANTOM_RAW=""
check_phantom_killer() {
    local v1 v2
    v1="$(settings get global settings_enable_monitor_phantom_procs 2>&1)"
    v2="$(/system/bin/device_config get activity_manager max_phantom_processes 2>&1)"
    PHANTOM_RAW="settings=[${v1}] device_config=[${v2}]"

    case "$v1" in
        false|0) return 0 ;;
        true|1)  return 1 ;;
    esac

    case "$v2" in
        ''|null|*[!0-9]*) return 2 ;;              # vazio, null ou erro/texto
        *) [ "$v2" -gt 1000 ] && return 0 || return 1 ;;
    esac
}

# ===========================================================================
#  COMANDO: doctor
# ===========================================================================

cmd_doctor() {
    header "Diagnóstico"

    local problems=0

    if [ "$CTX" != "termux" ]; then
        warn "rodando fora do Termux (contexto: $CTX) — checagens limitadas."
    else
        step "Apps do Android"
        check_android_app "com.termux.x11"; local x11_rc=$?
        case "$x11_rc" in
            0) ok "Termux:X11 instalado" ;;
            *) info "Termux:X11: não foi possível confirmar pelo terminal"
               info "o Android 11+ esconde a lista de apps de outros apps,"
               info "então isto NÃO quer dizer que falta — confira na gaveta"
               info "de apps. Se não tiver: github.com/termux/termux-x11/releases" ;;
        esac

        # O Termux:API NAO e necessario aqui. O termux-wake-lock vem do pacote
        # termux-tools (essencial, ja instalado) e fala direto com o TermuxService
        # do proprio app Termux. O Termux:API so serve para camera, SMS, sensores.
        info "Termux:API é opcional — este projeto não precisa dele"

        step "Restrição de processos filhos (Phantom Process Killer)"
        check_phantom_killer; local ph_rc=$?
        case "$ph_rc" in
            0) ok "restrição desativada" ;;
            1) err "restrição ATIVA — causa nº1 de o desktop morrer sozinho"
               info "Opções de desenvolvedor -> 'Desativar restrições de processos filhos'"
               info "e reinicie o celular. Detalhes: docs/01-pre-requisitos.md"
               problems=$((problems+1)) ;;
            *) info "não foi possível confirmar pelo terminal — o Android não deixa"
               info "o Termux ler essa configuração (precisa de root ou ADB)."
               info "Se você já ativou 'Desativar restrições de processos filhos'"
               info "nas Opções de desenvolvedor E reiniciou, está tudo certo."
               info "leitura crua: ${PHANTOM_RAW}" ;;
        esac

        step "Pacotes do Termux"
        local p
        for p in proot-distro termux-x11 pulseaudio; do
            if have "$p"; then ok "$p"
            else err "$p ausente"; problems=$((problems+1)); fi
        done
        have virgl_test_server_android && ok "virglrenderer-android (GPU alternativa)" \
            || info "virglrenderer-android ausente (opcional)"

        step "Ubuntu"
        resolve_rootfs
        if [ -d "$ROOTFS" ]; then
            ok "instalado em $ROOTFS"
            if [ -x "${ROOTFS}/usr/bin/startplasma-x11" ]; then
                ok "KDE Plasma instalado (sessão X11 presente)"
            elif [ -x "${ROOTFS}/usr/bin/startplasma-wayland" ]; then
                err "KDE instalado, mas SEM a sessão X11 (só Wayland)"
                info "é o Plasma 6: o startplasma-x11 mudou para o pacote"
                info "plasma-session-x11. Rode './lx setup' de novo para instalá-lo."
                problems=$((problems+1))
            else
                err "KDE Plasma NÃO instalado — rode: ./lx setup"
                problems=$((problems+1))
            fi

            if [ -f "${ROOTFS}/etc/linux-android-gpu.conf" ]; then
                ok "aceleração de GPU configurada (Turnip)"
            else
                warn "GPU não configurada — o desktop vai rodar na CPU (lento)"
                info "rode: ./lx gpu"
                problems=$((problems+1))
            fi
        else
            err "Ubuntu não instalado — rode: ./lx setup"
            problems=$((problems+1))
        fi

        step "Sessão em execução"
        pgrep -f "[t]ermux-x11" >/dev/null 2>&1 && ok "servidor X11 rodando" \
            || info "servidor X11 parado"
        pgrep -f "[s]tartplasma-x11" >/dev/null 2>&1 && ok "KDE rodando" \
            || info "KDE parado"
    fi

    echo
    if [ "$problems" -eq 0 ]; then
        printf '%s Tudo certo.%s\n' "$C_GRN$C_BOLD" "$C_RESET"
    else
        printf '%s %d ponto(s) de atenção acima.%s\n' "$C_YEL$C_BOLD" "$problems" "$C_RESET"
    fi
    return 0
}

# ===========================================================================
#  COMANDO: status
# ===========================================================================

cmd_status() {
    header "Status do linux-android (lx v${LX_VERSION})"
    say "Contexto: ${C_BOLD}${CTX}${C_RESET}"
    echo

    local -a steps=(
        "termux:Termux preparado (pacotes base)"
        "ubuntu:Ubuntu instalado"
        "kde:KDE Plasma instalado"
        "gpu:Aceleração de GPU ativada"
        "dev-termux:Ambiente dev no Termux"
        "dev-ubuntu:Ambiente dev no Ubuntu"
    )
    local entry key label
    for entry in "${steps[@]}"; do
        key="${entry%%:*}"; label="${entry#*:}"
        if state_has "$key"; then
            printf '  %s[x]%s %s\n' "$C_GRN" "$C_RESET" "$label"
        else
            printf '  %s[ ]%s %s%s%s\n' "$C_DIM" "$C_RESET" "$C_DIM" "$label" "$C_RESET"
        fi
    done

    echo
    say "Ambiente padrão do 'start': ${C_BOLD}$(read_default_de)${C_RESET}  ${C_DIM}(troque com 'lx de')${C_RESET}"
    echo
    info "'./lx setup' continua de onde parou · './lx doctor' diagnostica"
}

# ===========================================================================
#  Instalação: Termux
# ===========================================================================

install_termux_base() {
    require_termux "setup"
    header "1/4 — Preparando o Termux"

    step "Atualizando pacotes..."
    pkg update -y  || warn "pkg update retornou erro (seguindo)"
    pkg upgrade -y || warn "pkg upgrade retornou erro (seguindo)"

    step "Habilitando o repositório x11..."
    pkg install -y x11-repo || die "não consegui habilitar o x11-repo."
    # O índice do repo recém-habilitado precisa ser lido antes de instalar dele.
    pkg update -y || true

    step "Instalando proot-distro, Termux-X11, PulseAudio e utilitários..."
    pkg install -y proot-distro termux-x11-nightly pulseaudio git wget curl nano \
        || die "falha ao instalar os pacotes base."

    step "Instalando suporte a GPU alternativo (virgl)..."
    pkg install -y virglrenderer-android \
        || info "virgl indisponível — sem problema, o caminho principal é o Turnip."

    step "Configurando acesso ao armazenamento..."
    info "aceite a permissão na tela, se aparecer"
    termux-setup-storage || true

    state_set termux
    ok "Termux preparado."
}

install_ubuntu() {
    require_termux "setup"
    header "2/4 — Instalando o Ubuntu"

    resolve_rootfs
    if [ -d "$ROOTFS" ]; then
        ok "Ubuntu já instalado."
    else
        step "Baixando e instalando (pode demorar bastante)..."
        proot-distro install "$DISTRO" || die "falha ao instalar o Ubuntu."
        resolve_rootfs   # o rootfs acabou de nascer
        ok "Ubuntu instalado em $ROOTFS"
    fi
    state_set ubuntu
}

# ===========================================================================
#  Instalação: KDE (executa DENTRO do Ubuntu)
# ===========================================================================

install_kde_inside() {
    [ "$CTX" = "ubuntu" ] || die "install_kde_inside só roda dentro do Ubuntu."
    header "3/4 — Instalando o KDE Plasma"

    export DEBIAN_FRONTEND=noninteractive

    step "Atualizando o Ubuntu..."
    apt update || warn "apt update com erro (seguindo)"
    apt upgrade -y || warn "apt upgrade com erro (seguindo)"

    step "Instalando o KDE Plasma e dependências (demorado)..."
    # kde-plasma-desktop  = base do Plasma, mais enxuto que o kubuntu-desktop
    # dbus-x11            = necessário para iniciar via dbus-launch
    # libgl1-mesa-dri     = renderização por software (fallback sem GPU)
    # x11-xserver-utils   = xrandr, para ajustar resolução no monitor externo
    apt install -y \
        kde-plasma-desktop dbus-x11 \
        libgl1-mesa-dri mesa-utils x11-xserver-utils \
        konsole dolphin kate \
        sudo nano curl wget \
        pulseaudio-utils \
        fonts-noto fonts-noto-cjk \
        locales

    step "Configurando locale..."
    locale-gen en_US.UTF-8 pt_BR.UTF-8 || true
    update-locale LANG=pt_BR.UTF-8 || true

    # Fuso horário. O container nasce em UTC; o LX_TZ vem do Android
    # (getprop persist.sys.timezone) repassado por quem nos invocou.
    if [ -n "${LX_TZ:-}" ] && [ -f "/usr/share/zoneinfo/${LX_TZ}" ]; then
        step "Fuso horário: ${LX_TZ}"
        ln -sf "/usr/share/zoneinfo/${LX_TZ}" /etc/localtime
        printf '%s\n' "${LX_TZ}" > /etc/timezone
    fi

    step "Ajustando o KDE para proot..."
    mkdir -p /root/.config
    # Sem GPU o compositor pisca/trava. Com GPU dá para reativar (docs/07).
    cat > /root/.config/kwinrc <<'EOF'
[Compositing]
Enabled=false
EOF
    # O bloqueio de tela não funciona em proot e prende a sessão.
    cat > /root/.config/kscreenlockerrc <<'EOF'
[Daemon]
Autolock=false
LockOnResume=false
EOF

    # -----------------------------------------------------------------------
    # A sessao X11 do Plasma
    #
    # No Ubuntu 24.04 (Plasma 5) o startplasma-x11 vem dentro do
    # plasma-workspace. No 26.04 (Plasma 6) o plasma-workspace passou a trazer
    # SO o startplasma-wayland — a sessao X11 foi movida para o pacote
    # plasma-session-x11, e o compositor para kwin-x11.
    #
    # Sem isso o KDE instala "com sucesso" e o 'lx start' morre depois, porque
    # o binario que ele chama nao existe. Por isso instalamos sob demanda e
    # conferimos o resultado em vez de confiar no apt.
    # -----------------------------------------------------------------------
    if [ ! -x /usr/bin/startplasma-x11 ]; then
        step "Sessão X11 ausente (Plasma 6) — instalando plasma-session-x11..."
        apt install -y plasma-session-x11 kwin-x11 \
            || warn "não consegui instalar plasma-session-x11/kwin-x11"
    fi

    if [ ! -x /usr/bin/startplasma-x11 ]; then
        err "o KDE foi instalado, mas /usr/bin/startplasma-x11 não existe."
        info "sem ele o 'lx start' não tem como subir a sessão."
        info "tente manualmente:  lx shell  →  apt install -y plasma-session-x11 kwin-x11"
        info "se não houver esse pacote na sua versão do Ubuntu, use o XFCE"
        info "(veja docs/05-dicas-desempenho.md)"
        return 1
    fi

    # O apt guarda todos os .deb baixados em /var/cache/apt/archives. Depois
    # de instalar o Plasma inteiro isso passa de 1 GB parado — relevante num
    # celular, onde o rootfs divide espaco com fotos e videos.
    step "Limpando o cache de pacotes..."
    apt clean

    state_set kde
    ok "KDE Plasma instalado (sessão X11 confirmada)."
}

# ===========================================================================
#  Instalação: GPU (executa DENTRO do Ubuntu)
# ===========================================================================

install_gpu_inside() {
    [ "$CTX" = "ubuntu" ] || die "install_gpu_inside só roda dentro do Ubuntu."
    header "4/4 — Aceleração de GPU (Turnip / Adreno)"

    export DEBIAN_FRONTEND=noninteractive

    [ "$(uname -m)" = "aarch64" ] || die "este Mesa é só para arm64 (detectado: $(uname -m))."

    # shellcheck disable=SC1091
    . /etc/os-release
    local suffix
    case "${VERSION_CODENAME:-}" in
        noble)    suffix="ubuntu_noble_arm64"    ;;  # 24.04 LTS
        questing) suffix="ubuntu_questing_arm64" ;;  # 25.10
        resolute) suffix="ubuntu_resolute_arm64" ;;  # 26.04 LTS
        *)  warn "sem build de Mesa para '${VERSION_CODENAME:-?}'."
            info "use o caminho alternativo: ./lx start --gpu virgl"
            return 1 ;;
    esac

    step "Ubuntu ${VERSION_ID:-?} (${VERSION_CODENAME}) — build '${suffix}'"

    have curl || apt install -y curl ca-certificates >/dev/null 2>&1 || true
    apt install -y mesa-utils vulkan-tools >/dev/null 2>&1 || true

    step "Procurando o release mais recente..."
    local url
    url="$(gh_latest_asset "$MESA_REPO" "_${suffix}\.tar\.gz")"
    [ -n "$url" ] || { err "não achei o pacote '${suffix}'."
                       info "baixe manualmente: https://github.com/${MESA_REPO}/releases"
                       return 1; }
    info "$url"

    local tmp; tmp="$(mktemp /tmp/mesa-XXXXXX.tar.gz)"
    # shellcheck disable=SC2064
    trap "rm -f '$tmp'" RETURN

    step "Baixando (~11 MB)..."
    fetch "$url" "$tmp" || { err "download falhou."; return 1; }

    step "Extraindo e atualizando o linker..."
    tar -zxf "$tmp" -C / || { err "extração falhou."; return 1; }
    ldconfig

    # Marcador lido pelo 'lx start' no lado do Termux para ativar a GPU sozinho.
    cat > /etc/linux-android-gpu.conf <<'EOF'
# Gerado por 'lx gpu'
GPU_MODE=turnip
EOF

    state_set gpu
    ok "GPU ativada. Confira com: glxinfo -B  (dentro do KDE)"
}

# ===========================================================================
#  Navegador
# ===========================================================================
#
#  Tres armadilhas que este comando resolve:
#
#  1. A imagem OCI do Ubuntu vem so com 'main'. Quase tudo interessante
#     (navegadores, neofetch, falkon) esta em 'universe', e um
#     'apt install' falha com "Unable to locate package".
#
#  2. No Ubuntu, 'chromium-browser' e 'chromium' sao pacotes de TRANSICAO
#     que instalam o snap. Snap nao roda em proot (precisa de systemd e
#     de montagens privilegiadas). Instalar da a impressao de sucesso e
#     o navegador simplesmente nao abre.
#
#  3. O 'firefox' do Ubuntu tambem e snap. O Firefox de verdade em .deb
#     vem do repositorio oficial da Mozilla, que publica arm64.

enable_universe() {
    step "Habilitando o componente 'universe'..."
    if have add-apt-repository; then
        add-apt-repository -y universe >/dev/null 2>&1 && { apt update; return 0; }
    fi
    apt install -y software-properties-common >/dev/null 2>&1 \
        && add-apt-repository -y universe >/dev/null 2>&1 \
        && { apt update; return 0; }
    warn "não consegui habilitar o universe automaticamente"
    return 1
}

install_firefox_inside() {
    step "Configurando o repositório oficial da Mozilla (arm64)..."
    apt install -y wget gnupg ca-certificates >/dev/null 2>&1 || true

    install -d -m 0755 /etc/apt/keyrings
    wget -qO- https://packages.mozilla.org/apt/repo-signing-key.gpg \
        > /etc/apt/keyrings/packages.mozilla.org.asc \
        || { err "não consegui baixar a chave da Mozilla."; return 1; }

    echo "deb [signed-by=/etc/apt/keyrings/packages.mozilla.org.asc] https://packages.mozilla.org/apt mozilla main" \
        > /etc/apt/sources.list.d/mozilla.list

    # Sem o pin, o apt pode preferir o 'firefox' do Ubuntu — que e o snap.
    cat > /etc/apt/preferences.d/mozilla <<'PIN'
Package: *
Pin: origin packages.mozilla.org
Pin-Priority: 1000
PIN

    apt update || return 1
    step "Instalando o Firefox..."
    apt install -y firefox || { err "falha ao instalar o Firefox."; return 1; }

    # O sandbox do Firefox usa namespaces de usuario, que o proot nao oferece.
    # Sem isto as abas morrem ao abrir.
    cat > /etc/profile.d/firefox-proot.sh <<'ENVF'
# Gerado por 'lx browser' — o sandbox do Firefox nao funciona em proot.
export MOZ_DISABLE_CONTENT_SANDBOX=1
export MOZ_DISABLE_GMP_SANDBOX=1
export MOZ_ENABLE_WAYLAND=0
ENVF
    chmod 644 /etc/profile.d/firefox-proot.sh

    ok "Firefox instalado ($(firefox --version 2>/dev/null || echo 'versão desconhecida'))"
    info "atalho no menu do KDE, ou rode 'firefox' no Konsole"
}

install_falkon_inside() {
    step "Instalando o Falkon (navegador Qt do KDE, mais leve)..."
    apt install -y falkon || { err "falha ao instalar o Falkon."; return 1; }
    ok "Falkon instalado"
}

install_browser_inside() {
    [ "$CTX" = "ubuntu" ] || die "install_browser_inside só roda dentro do Ubuntu."
    export DEBIAN_FRONTEND=noninteractive
    local which_b="${1:-firefox}"

    header "Instalando navegador: ${which_b}"
    apt update || warn "apt update com erro (seguindo)"
    enable_universe || true

    case "$which_b" in
        firefox) install_firefox_inside ;;
        falkon)  install_falkon_inside ;;
        *) die "navegador desconhecido: '$which_b' (use: firefox | falkon)" ;;
    esac
}

# VS Code.
#
# Duas armadilhas:
#   1. Nao esta em nenhum repositorio do Ubuntu. Vem do repo da Microsoft, que
#      publica arm64 (conferido: Architectures inclui arm64).
#   2. E Electron. O sandbox do Chromium precisa de namespaces de usuario, que
#      o proot nao oferece — sem desativar, ele nem abre.
install_vscode_inside() {
    [ "$CTX" = "ubuntu" ] || die "install_vscode_inside só roda dentro do Ubuntu."
    export DEBIAN_FRONTEND=noninteractive

    header "Instalando o VS Code"

    if have code; then
        ok "já instalado ($(code --version 2>/dev/null | head -1))"
    else
        apt update || warn "apt update com erro (seguindo)"
        apt_install_soft wget gpg ca-certificates apt-transport-https

        step "Configurando o repositório da Microsoft (arm64)..."
        install -d -m 0755 /etc/apt/keyrings
        wget -qO- https://packages.microsoft.com/keys/microsoft.asc \
            | gpg --dearmor > /etc/apt/keyrings/microsoft.gpg \
            || { err "não consegui baixar a chave da Microsoft."; return 1; }

        echo "deb [arch=arm64 signed-by=/etc/apt/keyrings/microsoft.gpg] https://packages.microsoft.com/repos/code stable main" \
            > /etc/apt/sources.list.d/vscode.list

        apt update || return 1
        step "Instalando (~120 MB)..."
        apt install -y code || { err "falha ao instalar o VS Code."; return 1; }
    fi

    # O sandbox do Electron nao funciona em proot: o processo nem sobe.
    step "Desativando o sandbox do Electron (obrigatório em proot)..."
    cat > /etc/profile.d/vscode-proot.sh <<'ENVF'
# Gerado por 'lx vscode'. O sandbox do Chromium/Electron exige namespaces de
# usuario, indisponiveis em proot. Sem isto o VS Code nao abre.
export ELECTRON_DISABLE_SANDBOX=1
ENVF
    chmod 644 /etc/profile.d/vscode-proot.sh

    # Tambem no atalho do menu, senao abrir pelo lançador continua falhando.
    local d=/usr/share/applications/code.desktop
    if [ -f "$d" ] && ! grep -q -- '--no-sandbox' "$d"; then
        sed -i 's|^\(Exec=.*/code\)|\1 --no-sandbox|' "$d"
        sed -i 's|^\(Exec=/usr/share/code/code\)|\1 --no-sandbox|' "$d"
        ok "atalho do menu ajustado com --no-sandbox"
    fi

    # Wrapper para a linha de comando, para nao precisar lembrar da flag.
    cat > /usr/local/bin/code-proot <<'WRAP'
#!/usr/bin/env bash
exec /usr/bin/code --no-sandbox --disable-gpu-sandbox "$@"
WRAP
    chmod +x /usr/local/bin/code-proot

    cat <<'MSG'

============================================================
 VS Code instalado.

 Abra pelo menu do desktop, ou no terminal:

     code-proot .          (wrapper com as flags necessárias)
     code --no-sandbox .   (equivalente, à mão)

 O 'code' puro NÃO abre: o sandbox do Electron precisa de
 namespaces de usuário, que o proot não oferece.

 Extensões, temas e settings funcionam normalmente.
============================================================
MSG
}

cmd_vscode() {
    if [ "$CTX" = "ubuntu" ]; then
        install_vscode_inside
    else
        require_termux "vscode"
        require_ubuntu_installed
        run_in_ubuntu vscode-install
    fi
}

cmd_browser() {
    local which_b="${1:-firefox}"
    case "$which_b" in
        firefox|falkon) ;;
        *) die "navegador desconhecido: '$which_b' (use: firefox | falkon)" ;;
    esac
    if [ "$CTX" = "ubuntu" ]; then
        install_browser_inside "$which_b"
    else
        require_termux "browser"
        require_ubuntu_installed
        run_in_ubuntu browser-install "$which_b"
    fi
}


# ===========================================================================
#  Rice — bspwm + Catppuccin Mocha
# ===========================================================================
#
#  Escolha de componentes, e por que:
#
#    bspwm + sxhkd  tiling por arvore, tudo controlavel via 'bspc'
#    polybar        barra. (Waybar NAO serve: e Wayland-only, e aqui o
#                   Termux:X11 e um servidor X)
#    rofi           launcher
#    picom          cantos arredondados + transparencia
#    kitty          terminal acelerado por GPU — faz sentido com a Adreno ativa
#    dunst          notificacoes
#
#  Sobre o visual: cantos arredondados + gaps largos + transparencia simples
#  dao o resultado minimalista tipo Hyprland SEM blur. Blur e o efeito mais
#  caro de todos e derruba o desempenho em proot; tudo o mais e barato.
#
#  Hyprland nao e opcao: e Wayland puro. Rodar aninhado exigiria wlroots
#  compilado com backend X11, que os pacotes de distro nao trazem.

CATPPUCCIN_ROSEWATER="#f5e0dc"; CATPPUCCIN_MAUVE="#cba6f7"
CATPPUCCIN_BASE="#1e1e2e";      CATPPUCCIN_SURFACE="#313244"
CATPPUCCIN_TEXT="#cdd6f4";      CATPPUCCIN_BLUE="#89b4fa"

install_nerd_font_inside() {
    step "Fonte JetBrainsMono Nerd Font"
    if fc-list 2>/dev/null | grep -qi "JetBrainsMono Nerd"; then
        ok "já instalada"; return 0
    fi
    # A 'fonts-jetbrains-mono' do apt NAO tem os glifos de icone que a polybar
    # usa — precisa da versao "patched" do projeto nerd-fonts.
    local url tmp
    url="$(gh_latest_asset ryanoasis/nerd-fonts 'JetBrainsMono\.tar\.xz')"
    [ -n "$url" ] || { warn "não achei o release da Nerd Font"; return 1; }
    tmp="$(mktemp -d /tmp/nf-XXXXXX)"
    if fetch "$url" "$tmp/f.tar.xz"; then
        mkdir -p /usr/local/share/fonts/JetBrainsMonoNerd
        tar -xJf "$tmp/f.tar.xz" -C /usr/local/share/fonts/JetBrainsMonoNerd 2>/dev/null
        fc-cache -f >/dev/null 2>&1
        ok "instalada"
    else
        warn "download da fonte falhou"
    fi
    rm -rf "$tmp"
}

# $1 = modificador: super | alt | ctrl-alt
#
# O Samsung DeX intercepta a tecla Super no nivel do sistema (Win+B, Win+E,
# Win+L...) e esses atalhos sao hard-coded — nao ha como desativa-los. Num
# monitor via DeX, portanto, 'super' simplesmente nao chega ao X. Por isso o
# modificador e configuravel.
write_rice_configs() {
    local H="${HOME:-/root}"
    local mod="${1:-super}" modseq modnome ptrmod
    case "$mod" in
        super)    modseq="super";        modnome="super (tecla Windows)"; ptrmod="mod4" ;;
        alt)      modseq="alt";          modnome="alt";                   ptrmod="mod1" ;;
        ctrl-alt) modseq="ctrl + alt";   modnome="ctrl + alt";            ptrmod="mod1" ;;
        *) die "modificador inválido: '$mod' (use: super | alt | ctrl-alt)" ;;
    esac
    step "Escrevendo configurações em ${H}/.config"
    info "arquivos existentes são sobrescritos (é assim que as correções chegam)"
    mkdir -p "$H/.config"/{bspwm,sxhkd,polybar,picom,rofi,kitty,dunst}

    # ---------------- bspwm ----------------
    cat > "$H/.config/bspwm/bspwmrc" <<'BSPWM'
#!/bin/sh
# Gerado por 'lx rice'. Recarregue com: super + shift + r
#
# Este arquivo registra cada passo em /tmp/lx-bspwm.log. Com --shared-tmp esse
# /tmp e o mesmo do Termux, entao o 'lx log' consegue ler.
#
# POR QUE registrar: quando um componente nao inicia, o bspwm nao reclama — a
# tela simplesmente fica vazia, sem nenhuma pista do que faltou.

LXL=/tmp/lx-bspwm.log
: > "$LXL"
lxlog() { echo "[bspwmrc] $*" >> "$LXL"; }

lxlog "inicio | DISPLAY=$DISPLAY HOME=$HOME"

# Cada componente e opcional: a ausencia de um nao deve derrubar a sessao.
start() { # $1 = binario, resto = argumentos
    b="$1"; shift
    if command -v "$b" >/dev/null 2>&1; then
        "$b" "$@" >> "$LXL" 2>&1 &
        lxlog "$b iniciado"
    else
        lxlog "$b AUSENTE (instale com: apt install -y $b)"
    fi
}

pgrep -x sxhkd >/dev/null 2>&1 || start sxhkd

# Fundo. Se o xsetroot faltar, a tela fica PRETA em vez do roxo escuro — foi
# assim que descobrimos que ele nao estava rodando.
if command -v xsetroot >/dev/null 2>&1; then
    xsetroot -solid "#1e1e2e" && lxlog "xsetroot ok"
else
    lxlog "xsetroot AUSENTE (vem no pacote x11-xserver-utils)"
fi

# LX_NO_PICOM=1 desliga o compositor. Serve para isolar problemas de
# renderizacao: se a tela aparece sem picom, o culpado e ele.
if [ -n "${LX_NO_PICOM:-}" ]; then
    lxlog "picom desativado por LX_NO_PICOM"
else
    start picom --config "$HOME/.config/picom/picom.conf"
fi
start dunst

if [ -x "$HOME/.config/polybar/launch.sh" ]; then
    "$HOME/.config/polybar/launch.sh" >> "$LXL" 2>&1
    lxlog "polybar disparada"
else
    lxlog "launch.sh da polybar AUSENTE"
fi

bspc monitor -d 1 2 3 4 5 >> "$LXL" 2>&1 || lxlog "bspc monitor FALHOU"

# Gaps largos + borda fina: e o que da o ar "minimalista" do rice.
bspc config border_width          2
bspc config window_gap            14
bspc config top_padding           34   # espaco para a polybar
bspc config split_ratio           0.52
bspc config borderless_monocle    true
bspc config gapless_monocle       true
bspc config focus_follows_pointer true
bspc config pointer_modifier      @PTRMOD@

# Catppuccin Mocha
bspc config normal_border_color   "#313244"
bspc config active_border_color   "#45475a"
bspc config focused_border_color  "#cba6f7"
bspc config presel_feedback_color "#89b4fa"

bspc rule -a Kitty          state=tiled
bspc rule -a firefox        desktop='^1'
bspc rule -a Pavucontrol    state=floating

# Abre um terminal na primeira janela.
#
# POR QUE: um tiling WM sem janelas mostra so uma cor solida — sem icones,
# sem papel de parede, sem menu. E visualmente identico a uma falha. Pior
# ainda no celular, onde nao existe a tecla 'super' para abrir nada.
if [ -z "$(bspc query -N -d 2>/dev/null)" ]; then
    if command -v kitty >/dev/null 2>&1; then
        start kitty
    elif command -v xterm >/dev/null 2>&1; then
        start xterm
    else
        lxlog "NENHUM terminal disponivel — a tela vai ficar vazia"
    fi
fi

lxlog "fim do bspwmrc"
BSPWM
    chmod +x "$H/.config/bspwm/bspwmrc"

    # ---------------- sxhkd ----------------
    cat > "$H/.config/sxhkd/sxhkdrc" <<'SXHKD'
# Gerado por 'lx rice'.  Modificador: @MODNOME@

# --- essenciais ---
@MOD@ + Return
    kitty
@MOD@ + d
    rofi -show drun
@MOD@ + shift + q
    bspc node -c
@MOD@ + shift + r
    bspc wm -r
@MOD@ + shift + e
    bspc quit

# --- foco / movimento ---
@MOD@ + {h,j,k,l}
    bspc node -f {west,south,north,east}
@MOD@ + shift + {h,j,k,l}
    bspc node -s {west,south,north,east}

# --- layout ---
@MOD@ + f
    bspc node -t "~"fullscreen
@MOD@ + space
    bspc node -t "~"floating
@MOD@ + m
    bspc desktop -l next

# --- redimensionar ---
@MOD@ + control + {h,j,k,l}
    bspc node -z {left -40 0,bottom 0 40,top 0 -40,right 40 0}

# --- areas de trabalho ---
@MOD@ + {1-5}
    bspc desktop -f '^{1-5}'
@MOD@ + shift + {1-5}
    bspc node -d '^{1-5}' --follow

# --- extras ---
@MOD@ + shift + s
    rofi -show run
@MOD@ + b
    firefox
SXHKD

    # ---------------- picom ----------------
    cat > "$H/.config/picom/picom.conf" <<'PICOM'
# Gerado por 'lx rice'.
#
# SEM blur de proposito: e o efeito mais caro e o unico que realmente pesa
# em proot. Cantos arredondados + transparencia dao o mesmo visual por uma
# fracao do custo.

# backend: xrender, NAO glx.
#
# O backend glx congela a renderizacao sob o Termux:X11 — todo o desktop sobe
# (bspwm, polybar, terminal) e a tela fica PRETA, porque o picom redireciona as
# janelas para buffers e nunca consegue apresenta-las. E um problema conhecido
# do picom com glx (yshui/picom#1395), nao especifico daqui.
#
# O xrender nao tem esse problema e TAMBEM faz cantos arredondados, entao o
# visual nao perde nada. Se quiser experimentar o glx, troque aqui — mas se a
# tela ficar preta, foi isso.
backend = "xrender";
vsync = false;          # true costuma causar stutter sob o Termux:X11

corner-radius = 12;
round-borders = 1;

shadow = true;
shadow-radius = 14;
shadow-opacity = 0.35;
shadow-offset-x = -14;
shadow-offset-y = -14;

fading = true;
fade-in-step = 0.06;
fade-out-step = 0.06;

inactive-opacity = 0.92;
active-opacity = 1.00;
frame-opacity = 1.00;

detect-rounded-corners = true;
detect-client-opacity = true;
PICOM

    # ---------------- polybar ----------------
    cat > "$H/.config/polybar/config.ini" <<'POLY'
; Gerado por 'lx rice'. Catppuccin Mocha.

[colors]
base     = #1e1e2e
mantle   = #181825
surface  = #313244
text     = #cdd6f4
subtext  = #a6adc8
mauve    = #cba6f7
blue     = #89b4fa
green    = #a6e3a1
peach    = #fab387
red      = #f38ba8

[bar/main]
width         = 100%
height        = 28
radius        = 10
background    = ${colors.base}
foreground    = ${colors.text}
line-size     = 2
padding       = 1
module-margin = 1
offset-x      = 8
offset-y      = 6
font-0        = JetBrainsMono Nerd Font:size=10;2
font-1        = JetBrainsMono Nerd Font:size=13;3
modules-left   = launcher term bspwm
modules-center = title
modules-right  = cpu memory date
cursor-click   = pointer
enable-ipc     = true

; Botoes clicaveis — a unica forma de abrir programas SEM teclado fisico.
; No celular nao existe a tecla 'super', entao os atalhos do sxhkd nao servem.
; Usamos 'label' (e nao 'content'): na polybar 3.7 o 'content' esta deprecado.
[module/launcher]
type = custom/text
label = " ☰ "
label-foreground = ${colors.mauve}
label-background = ${colors.surface}
click-left = rofi -show drun

[module/term]
type = custom/text
label = " ❯ "
label-foreground = ${colors.green}
click-left = kitty

[module/bspwm]
type = internal/bspwm
label-focused            = %name%
label-focused-background = ${colors.surface}
label-focused-foreground = ${colors.mauve}
label-focused-padding    = 1
label-occupied           = %name%
label-occupied-foreground = ${colors.subtext}
label-occupied-padding   = 1
label-empty              = %name%
label-empty-foreground   = #585b70
label-empty-padding      = 1

[module/title]
type = internal/xwindow
label = %title:0:60:...%
label-foreground = ${colors.subtext}

[module/cpu]
type = internal/cpu
interval = 2
format-prefix = " "
format-prefix-foreground = ${colors.peach}
label = %percentage:2%%

[module/memory]
type = internal/memory
interval = 3
format-prefix = " "
format-prefix-foreground = ${colors.green}
label = %gb_used%

[module/date]
type = internal/date
interval = 30
date = %H:%M
date-alt = %d/%m %H:%M
format-prefix = " "
format-prefix-foreground = ${colors.blue}
label = %date%
POLY

    cat > "$H/.config/polybar/launch.sh" <<'PLAUNCH'
#!/usr/bin/env bash
killall -q polybar 2>/dev/null
while pgrep -x polybar >/dev/null; do sleep 0.3; done
polybar main -c "$HOME/.config/polybar/config.ini" >>/tmp/lx-bspwm.log 2>&1 &
PLAUNCH
    chmod +x "$H/.config/polybar/launch.sh"

    # ---------------- rofi ----------------
    cat > "$H/.config/rofi/config.rasi" <<'ROFI'
configuration {
    modi: "drun,run,window";
    show-icons: true;
    icon-theme: "Papirus-Dark";
    font: "JetBrainsMono Nerd Font 11";
    drun-display-format: "{name}";
}
* {
    bg:     #1e1e2e;
    bg-alt: #313244;
    fg:     #cdd6f4;
    accent: #cba6f7;
    background-color: transparent;
    text-color: @fg;
}
window   { background-color: @bg; border-radius: 12px; width: 46%; padding: 12px; }
inputbar { background-color: @bg-alt; border-radius: 8px; padding: 8px; spacing: 8px; }
prompt   { text-color: @accent; }
listview { lines: 8; spacing: 4px; padding: 8px 0 0 0; }
element  { padding: 8px; border-radius: 8px; }
element selected { background-color: @accent; text-color: @bg; }
element-icon { size: 20px; padding: 0 8px 0 0; }
ROFI

    # ---------------- kitty ----------------
    cat > "$H/.config/kitty/kitty.conf" <<'KITTY'
# Gerado por 'lx rice'. Catppuccin Mocha.
font_family      JetBrainsMono Nerd Font
font_size        11.0
window_padding_width 10
background_opacity   0.92
confirm_os_window_close 0
enable_audio_bell no

foreground #cdd6f4
background #1e1e2e
selection_foreground #1e1e2e
selection_background #f5e0dc
cursor #f5e0dc
url_color #f5e0dc
active_border_color   #b4befe
inactive_border_color #6c7086
active_tab_foreground   #11111b
active_tab_background   #cba6f7
inactive_tab_foreground #cdd6f4
inactive_tab_background #181825

color0 #45475a
color8 #585b70
color1 #f38ba8
color9 #f38ba8
color2 #a6e3a1
color10 #a6e3a1
color3 #f9e2af
color11 #f9e2af
color4 #89b4fa
color12 #89b4fa
color5 #f5c2e7
color13 #f5c2e7
color6 #94e2d5
color14 #94e2d5
color7 #bac2de
color15 #a6adc8
KITTY

    # ---------------- dunst ----------------
    cat > "$H/.config/dunst/dunstrc" <<'DUNST'
[global]
    monitor = 0
    follow = none
    width = 320
    # dunst 1.12+ pede tupla: (minimo, maximo). (0, X) = altura dinamica.
    height = (0, 120)
    origin = top-right
    # e offset em (N, N), nao mais NxN.
    offset = (14, 44)
    corner_radius = 10
    frame_width = 2
    frame_color = "#cba6f7"
    separator_color = frame
    font = JetBrainsMono Nerd Font 10
    padding = 12
    horizontal_padding = 12

[urgency_low]
    background = "#1e1e2e"
    foreground = "#cdd6f4"
[urgency_normal]
    background = "#1e1e2e"
    foreground = "#cdd6f4"
[urgency_critical]
    background = "#1e1e2e"
    foreground = "#f38ba8"
    frame_color = "#f38ba8"
DUNST

    # Aplica o modificador escolhido nos arquivos gerados.
    sed -i -e "s/@MOD@/${modseq}/g" -e "s/@MODNOME@/${modnome}/g" "$H/.config/sxhkd/sxhkdrc"
    sed -i -e "s/@PTRMOD@/${ptrmod}/g" "$H/.config/bspwm/bspwmrc"

    ok "configurações escritas (modificador: ${modnome})"
}

install_rice_inside() {
    [ "$CTX" = "ubuntu" ] || die "install_rice_inside só roda dentro do Ubuntu."
    export DEBIAN_FRONTEND=noninteractive
    local mod="${1:-}"

    # Lembra a escolha, para um 'lx rice' futuro nao voltar ao padrao.
    state_init
    if [ -n "$mod" ]; then
        printf '%s\n' "$mod" > "${STATE_DIR}/rice-mod" 2>/dev/null || true
    else
        mod="$(cat "${STATE_DIR}/rice-mod" 2>/dev/null)"
        [ -n "$mod" ] || mod="super"
    fi

    header "Rice: bspwm + Catppuccin Mocha"

    apt update || warn "apt update com erro (seguindo)"
    enable_universe || true

    step "Instalando os componentes..."
    # Quase todos estao em 'universe' — por isso o enable_universe acima.
    # Nada de 'xsetroot' aqui: NAO existe pacote com esse nome. O binario vem
    # dentro de x11-xserver-utils, que e o que pedimos.
    apt_install_soft \
        bspwm sxhkd polybar rofi picom dunst \
        kitty feh x11-xserver-utils xdotool wmctrl \
        libnotify-bin papirus-icon-theme fontconfig

    install_nerd_font_inside
    write_rice_configs "$mod"

    # Confere os binarios de verdade, em vez de confiar no apt.
    local faltando="" b
    for b in bspwm sxhkd polybar rofi picom kitty xsetroot; do
        have "$b" || faltando="${faltando} ${b}"
    done
    if [ -n "$faltando" ]; then
        warn "faltaram:${faltando}"
        for b in $faltando; do
            case "$b" in
                xsetroot) info "  xsetroot vem em: x11-xserver-utils" ;;
                *)        info "  tente: apt install -y $b" ;;
            esac
        done
    fi
    if ! have bspwm; then
        err "o bspwm não foi instalado — o rice não vai subir."
        info "rode 'lx rice' de novo; se insistir, instale à mão com 'lx shell'"
        return 1
    fi

    # Nome do modificador para as instrucoes (o heredoc abaixo expande).
    local M
    case "$mod" in
        alt)      M="alt" ;;
        ctrl-alt) M="ctrl+alt" ;;
        *)        M="super" ;;
    esac

    cat <<MSG

============================================================
 Rice instalado.  Modificador: ${M}

 Para iniciar, no TERMUX:

     lx stop
     lx start --de bspwm

 Atalhos:

     ${M} + Enter        terminal (kitty)
     ${M} + d            launcher (rofi)
     ${M} + b            navegador
     ${M} + 1..5         trocar de área de trabalho
     ${M} + h/j/k/l      mover o foco
     ${M} + shift + hjkl mover a janela
     ${M} + f            tela cheia
     ${M} + space        flutuante
     ${M} + shift + q    fechar janela
     ${M} + shift + r    recarregar o bspwm
     ${M} + shift + e    sair da sessão

 No Samsung DeX a tecla Super NAO funciona: o DeX a intercepta no
 nível do sistema (Win+B, Win+E, Win+L...) e esses atalhos são
 hard-coded. Se estiver no DeX, use:

     lx rice --mod alt

 Sem teclado físico, use os botões da barra: ☰ (launcher) e ❯ (terminal).

 Para voltar ao KDE:  lx start --de kde
============================================================
MSG
}

cmd_rice() {
    local mod=""
    while [ $# -gt 0 ]; do
        case "$1" in
            --mod)
                [ $# -ge 2 ] || die "--mod exige um valor: super | alt | ctrl-alt"
                mod="$2"; shift 2 ;;
            super|alt|ctrl-alt) mod="$1"; shift ;;
            *) die "argumento inválido em 'rice': $1 (use: --mod super|alt|ctrl-alt)" ;;
        esac
    done
    case "${mod:-}" in
        ''|super|alt|ctrl-alt) ;;
        *) die "modificador inválido: '$mod' (use: super | alt | ctrl-alt)" ;;
    esac

    if [ "$CTX" = "ubuntu" ]; then
        install_rice_inside "$mod"
    else
        require_termux "rice"
        require_ubuntu_installed
        run_in_ubuntu rice-install "$mod"
    fi
}

# ===========================================================================
#  Ambiente de desenvolvimento
# ===========================================================================

setup_ohmyzsh() {
    local home="$1"
    step "Oh My Zsh + tema darkblood"

    if [ -d "$home/.oh-my-zsh" ]; then
        ok "Oh My Zsh já instalado"
    else
        RUNZSH=no CHSH=no KEEP_ZSHRC=no \
            sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" \
            "" --unattended || { warn "falha ao instalar o Oh My Zsh"; return 1; }
    fi

    # darkblood é um tema que já vem com o Oh My Zsh — não precisa baixar nada.
    if [ -f "$home/.zshrc" ]; then
        sed -i 's/^ZSH_THEME=.*/ZSH_THEME="darkblood"/' "$home/.zshrc"
        grep -q '^ZSH_THEME=' "$home/.zshrc" || echo 'ZSH_THEME="darkblood"' >> "$home/.zshrc"
        ok "tema darkblood configurado"
    fi
}

append_shell_rc() {
    # Acrescenta um bloco idempotente aos rc do bash e do zsh.
    local home="$1" marker="# >>> lx dev >>>" body="$2" f
    for f in "$home/.zshrc" "$home/.bashrc"; do
        [ -f "$f" ] || continue
        grep -qF "$marker" "$f" && continue
        {
            echo ""
            echo "$marker"
            echo "$body"
            echo "# <<< lx dev <<<"
        } >> "$f"
    done
}

setup_nvchad() {
    local home="$1"
    step "NvChad (configuração do Neovim)"

    if [ -d "$home/.config/nvim" ]; then
        if [ -d "$home/.config/nvim/lua/chadrc.lua" ] || [ -f "$home/.config/nvim/lua/chadrc.lua" ]; then
            ok "NvChad já instalado"; return 0
        fi
        local bak="$home/.config/nvim.bak.$$"
        warn "já existe uma config do Neovim — movendo para $bak"
        mv "$home/.config/nvim" "$bak"
    fi

    mkdir -p "$home/.config"
    git clone -q --depth 1 https://github.com/NvChad/starter "$home/.config/nvim" \
        || { warn "falha ao clonar o NvChad"; return 1; }
    rm -rf "$home/.config/nvim/.git"
    ok "NvChad instalado — na primeira execução do 'nvim' ele baixa os plugins"
}

dev_termux() {
    require_termux "dev"
    header "Ambiente de desenvolvimento — Termux"

    step "Instalando pacotes"
    # Estes existem todos nos repositórios do Termux.
    pkg_install_soft \
        zsh git tmux btop bat fzf lazygit \
        neovim nodejs ripgrep fd \
        clang make python openssh

    # fastfetch substitui o neofetch, que está descontinuado desde 2024.
    if pkg install -y fastfetch 2>/dev/null; then
        ok "fastfetch instalado"
    else
        pkg install -y neofetch 2>/dev/null && ok "neofetch instalado" \
            || warn "nem fastfetch nem neofetch disponíveis"
    fi

    setup_ohmyzsh "$HOME"
    setup_nvchad  "$HOME"

    step "Aliases e configurações"
    append_shell_rc "$HOME" '
# bat: no Termux o binário já se chama "bat"
alias cat="bat --paging=never"
alias ls="ls --color=auto"
alias ll="ls -lah"
alias lg="lazygit"
alias vim="nvim"
alias v="nvim"

# fzf
[ -f "$PREFIX/share/fzf/key-bindings.zsh" ] && source "$PREFIX/share/fzf/key-bindings.zsh" 2>/dev/null
[ -f "$PREFIX/share/fzf/completion.zsh" ]   && source "$PREFIX/share/fzf/completion.zsh"   2>/dev/null

# claude: roda dentro do Ubuntu (glibc), ver "lx dev"
'

    setup_tmux_conf "$HOME"
    [ -n "${LX_NO_CLAUDE:-}" ] || install_claude_wrapper

    step "Shell padrão"
    if [ "$(basename "${SHELL:-}")" != "zsh" ]; then
        if chsh -s zsh 2>/dev/null; then ok "zsh definido como shell padrão"
        else info "não consegui trocar o shell — rode manualmente: chsh -s zsh"; fi
    else
        ok "zsh já é o shell padrão"
    fi

    state_set dev-termux
    echo
    ok "Ambiente dev do Termux pronto. Abra um novo terminal para carregar o zsh."
}

setup_tmux_conf() {
    local home="$1" f="$1/.tmux.conf"
    [ -f "$f" ] && { ok "~/.tmux.conf já existe (não sobrescrevi)"; return 0; }
    cat > "$f" <<'EOF'
# Gerado por 'lx dev' — ajuste à vontade.
set -g mouse on
set -g base-index 1
setw -g pane-base-index 1
set -g history-limit 10000
set -g default-terminal "screen-256color"
set -sg escape-time 10

# Dividir painéis mantendo o diretório atual
bind | split-window -h -c "#{pane_current_path}"
bind - split-window -v -c "#{pane_current_path}"

# Navegar entre painéis com Alt+setas, sem prefixo
bind -n M-Left  select-pane -L
bind -n M-Right select-pane -R
bind -n M-Up    select-pane -U
bind -n M-Down  select-pane -D
EOF
    ok "~/.tmux.conf criado"
}

# Wrapper no Termux que executa o Claude Code dentro do Ubuntu.
#
# Por quê: o Claude Code é distribuído como binário linkado com glibc. O Android
# usa bionic libc, então a instalação nativa no Termux falha com
# "Unsupported platform: android arm64". Dentro do proot Ubuntu é glibc de
# verdade e ele roda normalmente. O wrapper faz isso ficar transparente:
# você digita 'claude' no Termux e ele roda no Ubuntu, no mesmo diretório.
install_claude_wrapper() {
    require_termux "install_claude_wrapper"
    local bin="${PREFIX}/bin/claude"

    step "Wrapper do Claude Code"
    cat > "$bin" <<'WRAPPER'
#!/usr/bin/env bash
# Executa o Claude Code dentro do Ubuntu (proot), no diretório atual.
# Gerado por 'lx dev'.
set -euo pipefail

DISTRO="ubuntu"
# O proot-distro v5 mudou o layout; aceitamos os dois.
BASE="${PREFIX}/var/lib/proot-distro"
ROOTFS="${BASE}/containers/${DISTRO}/rootfs"
[ -d "$ROOTFS" ] || ROOTFS="${BASE}/installed-rootfs/${DISTRO}"

if [ ! -d "$ROOTFS" ]; then
    echo "claude: o Ubuntu não está instalado. Rode: lx setup" >&2
    exit 1
fi
if [ ! -x "${ROOTFS}/usr/bin/claude" ] && [ ! -e "${ROOTFS}/usr/local/bin/claude" ] \
   && [ ! -e "${ROOTFS}/usr/bin/claude" ]; then
    echo "claude: não encontrado dentro do Ubuntu. Rode: lx dev ubuntu" >&2
    exit 1
fi

# Preserva o diretório atual dentro do proot, quando o caminho existir lá.
cwd="$PWD"
args=""
for a in "$@"; do args="$args $(printf '%q' "$a")"; done

exec proot-distro login "$DISTRO" --shared-tmp \
    --bind "$cwd:$cwd" \
    -- /bin/bash -lc "cd $(printf '%q' "$cwd") && claude$args"
WRAPPER
    chmod +x "$bin"
    ok "comando 'claude' disponível no Termux (executa no Ubuntu)"
}

dev_ubuntu_inside() {
    [ "$CTX" = "ubuntu" ] || die "dev_ubuntu_inside só roda dentro do Ubuntu."
    header "Ambiente de desenvolvimento — Ubuntu"

    export DEBIAN_FRONTEND=noninteractive
    local home="${HOME:-/root}"

    step "Instalando pacotes do apt"
    apt update || warn "apt update com erro (seguindo)"
    apt_install_soft \
        zsh git tmux btop bat fzf ripgrep fd-find \
        curl wget unzip build-essential \
        nodejs npm python3 python3-pip

    # No Debian/Ubuntu o binário do bat se chama 'batcat' (conflito de nome com
    # outro pacote antigo). Criamos um link para 'bat' funcionar como esperado.
    if have batcat && ! have bat; then
        mkdir -p /usr/local/bin && ln -sf "$(command -v batcat)" /usr/local/bin/bat
        ok "link bat -> batcat criado"
    fi
    if have fdfind && ! have fd; then
        mkdir -p /usr/local/bin && ln -sf "$(command -v fdfind)" /usr/local/bin/fd
    fi

    # ---- Neovim -----------------------------------------------------------
    # O Ubuntu 24.04 traz Neovim 0.9.5, mas o NvChad exige 0.10+. Por isso
    # instalamos o tarball oficial em vez de usar o apt.
    step "Neovim (tarball oficial — o do apt é antigo demais para o NvChad)"
    local nv_url nv_tmp
    nv_url="$(gh_latest_asset neovim/neovim 'nvim-linux-arm64\.tar\.gz')"
    if [ -n "$nv_url" ]; then
        nv_tmp="$(mktemp /tmp/nvim-XXXXXX.tar.gz)"
        if fetch "$nv_url" "$nv_tmp"; then
            rm -rf /opt/nvim
            mkdir -p /opt/nvim
            tar -zxf "$nv_tmp" -C /opt/nvim --strip-components=1
            ln -sf /opt/nvim/bin/nvim /usr/local/bin/nvim
            ok "Neovim $(/usr/local/bin/nvim --version | head -n1 | awk '{print $2}') instalado"
        else
            warn "download do Neovim falhou — caindo para o apt"
            apt install -y neovim || true
        fi
        rm -f "$nv_tmp"
    else
        warn "não achei o release do Neovim — caindo para o apt"
        apt install -y neovim || true
    fi

    # ---- lazygit ----------------------------------------------------------
    # Não está nos repositórios do Ubuntu 24.04; instalamos o binário oficial.
    step "lazygit (binário oficial — não está no apt do 24.04)"
    if have lazygit; then
        ok "lazygit já instalado"
    else
        local lg_url lg_tmp
        lg_url="$(gh_latest_asset jesseduffield/lazygit 'linux_arm64\.tar\.gz')"
        if [ -n "$lg_url" ]; then
            lg_tmp="$(mktemp -d /tmp/lazygit-XXXXXX)"
            if fetch "$lg_url" "$lg_tmp/lg.tar.gz"; then
                tar -zxf "$lg_tmp/lg.tar.gz" -C "$lg_tmp" lazygit 2>/dev/null \
                    && install -m 755 "$lg_tmp/lazygit" /usr/local/bin/lazygit \
                    && ok "lazygit instalado"
            fi
            rm -rf "$lg_tmp"
        else
            warn "não achei o release do lazygit"
        fi
    fi

    # ---- fastfetch --------------------------------------------------------
    step "fastfetch (sucessor do neofetch, descontinuado em 2024)"
    if have fastfetch; then
        ok "fastfetch já instalado"
    elif apt install -y fastfetch 2>/dev/null; then
        ok "fastfetch via apt"
    else
        local ff_url ff_tmp
        ff_url="$(gh_latest_asset fastfetch-cli/fastfetch 'linux-aarch64\.deb')"
        if [ -n "$ff_url" ]; then
            ff_tmp="$(mktemp /tmp/fastfetch-XXXXXX.deb)"
            if fetch "$ff_url" "$ff_tmp"; then
                apt install -y "$ff_tmp" >/dev/null 2>&1 || dpkg -i "$ff_tmp" >/dev/null 2>&1 || true
                have fastfetch && ok "fastfetch instalado" || warn "fastfetch falhou"
            fi
            rm -f "$ff_tmp"
        fi
        have fastfetch || { apt install -y neofetch 2>/dev/null && ok "neofetch (fallback)"; }
    fi

    # ---- Claude Code ------------------------------------------------------
    step "Claude Code"
    if [ -n "${LX_NO_CLAUDE:-}" ]; then
        info "pulado (--no-claude)"
    elif have claude; then
        ok "Claude Code já instalado"
    elif have npm; then
        # Aqui é glibc de verdade, então a instalação oficial funciona —
        # ao contrário do Termux nativo (bionic libc).
        npm install -g @anthropic-ai/claude-code \
            && ok "Claude Code instalado" \
            || warn "falha ao instalar o Claude Code (rode 'npm install -g @anthropic-ai/claude-code' à mão)"
    else
        warn "npm não disponível — Claude Code não instalado"
    fi

    setup_ohmyzsh "$home"
    setup_nvchad  "$home"
    setup_tmux_conf "$home"

    step "Aliases e configurações"
    append_shell_rc "$home" '
alias cat="bat --paging=never"
alias ls="ls --color=auto"
alias ll="ls -lah"
alias lg="lazygit"
alias vim="nvim"
alias v="nvim"
export PATH="/opt/nvim/bin:/usr/local/bin:$PATH"

# fzf
[ -f /usr/share/doc/fzf/examples/key-bindings.zsh ] && source /usr/share/doc/fzf/examples/key-bindings.zsh 2>/dev/null
[ -f /usr/share/doc/fzf/examples/completion.zsh ]   && source /usr/share/doc/fzf/examples/completion.zsh   2>/dev/null
'

    step "Shell padrão"
    chsh -s "$(command -v zsh)" root 2>/dev/null && ok "zsh definido para o root" \
        || info "não consegui trocar o shell (rode: chsh -s \$(which zsh))"

    state_set dev-ubuntu
    echo
    ok "Ambiente dev do Ubuntu pronto."
}

cmd_dev() {
    local target="both"
    while [ $# -gt 0 ]; do
        case "$1" in
            --no-claude) export LX_NO_CLAUDE=1; shift ;;
            termux|ubuntu|both) target="$1"; shift ;;
            *) die "argumento inválido em 'dev': $1 (use: termux | ubuntu | both | --no-claude)" ;;
        esac
    done

    case "$target" in
        termux)
            require_termux "dev termux"
            dev_termux
            ;;
        ubuntu)
            if [ "$CTX" = "ubuntu" ]; then
                dev_ubuntu_inside
            else
                require_termux "dev ubuntu"
                require_ubuntu_installed
                run_in_ubuntu dev ubuntu
                state_set dev-ubuntu
            fi
            ;;
        both|"")
            require_termux "dev"
            dev_termux
            require_ubuntu_installed
            run_in_ubuntu dev ubuntu
            state_set dev-ubuntu
            ;;
        *)
            die "alvo inválido: '$target'. Use: termux | ubuntu | both"
            ;;
    esac
}

# ===========================================================================
#  COMANDO: setup
# ===========================================================================

cmd_setup() {
    require_termux "setup"
    header "Instalação completa"
    info "Cada etapa é pulada se já estiver feita. Pode rodar de novo sem medo."
    echo

    state_has termux || install_termux_base
    state_has ubuntu || install_ubuntu

    resolve_rootfs
    if [ -x "${ROOTFS}/usr/bin/startplasma-x11" ]; then
        state_set kde
        ok "KDE já instalado."
    else
        run_in_ubuntu setup-kde || die "falha ao instalar o KDE."
        state_set kde
    fi

    if [ -f "${ROOTFS}/etc/linux-android-gpu.conf" ]; then
        state_set gpu
        ok "GPU já configurada."
    else
        run_in_ubuntu setup-gpu && state_set gpu \
            || warn "GPU não configurada — o desktop vai usar a CPU. Rode './lx gpu' depois."
    fi

    # Com o desktop instalado, vale deixar o comando acessível de qualquer pasta.
    have lx || { echo; cmd_install || true; }

    echo
    header "Pronto"
    local p="./lx"; have lx && p="lx"
    say "  $p doctor    conferir se falta algo do lado do Android"
    say "  $p dev       instalar o ambiente de desenvolvimento"
    say "  $p start     iniciar o desktop"
    echo
    cmd_doctor
}

# ===========================================================================
#  COMANDO: start / stop
# ===========================================================================

resolve_gpu_mode() {
    local mode="${1:-auto}"
    if [ "$mode" = "auto" ]; then
        if [ -f "${ROOTFS}/etc/linux-android-gpu.conf" ] &&
           grep -q "GPU_MODE=turnip" "${ROOTFS}/etc/linux-android-gpu.conf" 2>/dev/null; then
            mode="turnip"
        else
            mode="software"
        fi
    fi
    case "$mode" in
        turnip|virgl|software) echo "$mode" ;;
        *) return 1 ;;
    esac
}

cmd_start() {
    require_termux "start"
    require_ubuntu_installed

    local gpu_mode="auto" x11_extra="${X11_EXTRA:-}" use_alt=0 de="${LX_DE:-$(read_default_de)}" verbose=0 no_picom=0 vsync="${LX_VSYNC:-off}"

    while [ $# -gt 0 ]; do
        case "$1" in
            # Checar $# antes do 'shift 2' não é zelo excessivo: se faltar o
            # valor, o shift falha sem alterar $#, o case casa de novo e o
            # laço gira para sempre — travando o Termux.
            --gpu)
                [ $# -ge 2 ] || die "--gpu exige um valor: auto | turnip | virgl | software"
                gpu_mode="$2"; shift 2 ;;
            --extra)
                [ $# -ge 2 ] || die "--extra exige um valor, ex: --extra \"-force-bgra\""
                x11_extra="$2"; shift 2 ;;
            --de)
                [ $# -ge 2 ] || die "--de exige um valor: kde | bspwm | xfce"
                de="$2"; shift 2 ;;
            --alt)   use_alt=1; shift ;;
            --vsync)
                [ $# -ge 2 ] || die "--vsync exige um valor: on | off"
                case "$2" in on|off) vsync="$2" ;; *) die "--vsync: use 'on' ou 'off'" ;; esac
                shift 2 ;;
            --no-picom) no_picom=1; shift ;;
            -v|--verbose) verbose=1; shift ;;
            *) die "opção desconhecida em 'start': $1" ;;
        esac
    done

    gpu_mode="$(resolve_gpu_mode "$gpu_mode")" \
        || die "GPU_MODE inválido. Use: auto | turnip | virgl | software"

    # Cada ambiente tem seu comando de sessao. Conferimos o binario no rootfs
    # antes de subir: sem isto o X sobe, o cliente morre na hora e o usuario ve
    # so uma tela preta, sem pista do motivo.
    local session_cmd session_bin
    case "$de" in
        kde)   session_bin="startplasma-x11" ;;
        bspwm) session_bin="bspwm"           ;;
        xfce)  session_bin="startxfce4"      ;;
        *) die "ambiente desconhecido: '$de' (use: kde | bspwm | xfce)" ;;
    esac
    session_cmd="$session_bin"

    if [ ! -x "${ROOTFS}/usr/bin/${session_bin}" ]; then
        err "'${session_bin}' não encontrado dentro do Ubuntu."
        case "$de" in
            bspwm) info "instale o ambiente rice com:  lx rice" ;;
            xfce)  info "instale com:  lx shell  →  apt install -y xfce4 xfce4-terminal" ;;
            kde)   info "rode:  lx setup" ;;
        esac
        exit 1
    fi

    # Os arquivos de config do rice sao escritos pelo 'lx rice', nao pelo
    # 'git pull'. Sem este aviso, quem atualiza o lx continua rodando configs
    # antigos e as correcoes nao surtem efeito — foi o que aconteceu com o log
    # de passos do bspwmrc, que nunca apareceu porque o arquivo era o antigo.
    if [ "$de" = "bspwm" ]; then
        local rc="${ROOTFS}/root/.config/bspwm/bspwmrc"
        if [ -f "$rc" ] && ! grep -q "lxlog" "$rc" 2>/dev/null; then
            warn "os arquivos de configuração do rice são de uma versão antiga"
            info "rode 'lx rice' para regerá-los (o git pull não faz isso)"
        fi
    fi

    header "Iniciando o desktop"
    say "Ambiente:     ${C_BOLD}${de}${C_RESET}"
    say "Renderização: ${C_BOLD}${gpu_mode}${C_RESET}"
    [ "$gpu_mode" = "software" ] && info "rode './lx gpu' para ativar a GPU (bem mais rápido)"

    step "Encerrando sessões antigas..."
    stop_everything quiet

    termux-wake-lock 2>/dev/null || warn "não consegui adquirir o wake-lock"

    step "Iniciando o PulseAudio..."
    pulseaudio --start --exit-idle-time=-1 \
        --load="module-native-protocol-tcp auth-ip-acl=127.0.0.1 auth-anonymous=1" \
        || warn "PulseAudio não subiu — o desktop funciona, mas sem áudio"

    if [ "$gpu_mode" = "virgl" ]; then
        step "Iniciando o servidor virgl..."
        have virgl_test_server_android \
            || die "virgl_test_server_android ausente. Rode: pkg install virglrenderer-android"
        virgl_test_server_android >/dev/null 2>&1 &
        sleep 1
    fi

    # TMPDIR sempre existe no Termux, mas o script roda com 'set -u': se algum
    # ambiente estranho não o definir, a falha seria um erro cru de bash.
    export XDG_RUNTIME_DIR="${TMPDIR:-$PREFIX/tmp}"
    LX_LOG="${TMPDIR:-$PREFIX/tmp}/lx-session.log"

    # Ruido estrutural: componentes que procuram servicos que NUNCA vao existir
    # em proot. Nao sao avisos uteis — sao a mesma frase repetida aos milhares.
    #
    # O QT_LOGGING_RULES pega so as linhas com prefixo de categoria Qt; a
    # segunda linha de cada par do kpipewire e escrita direto no stderr, sem
    # categoria, e escapa das regras. Por isso filtramos aqui tambem.
    readonly LX_NOISE='kpipewire|Failed to connect to PipeWire|Media monitor will not work|MESA-LOADER: failed to retrieve device information|os_same_file_description'


    # Fuso horário: o proot não herda o do Android, então o relógio do KDE
    # aparece em UTC (3h à frente no Brasil). Lemos a zona do Android e a
    # repassamos — assim não precisamos alterar nada dentro do container.
    local tz
    tz="$(getprop persist.sys.timezone 2>/dev/null)"
    [ -n "$tz" ] && info "fuso horário: $tz"

    # O ambiente que roda dentro do Ubuntu é o mesmo nos dois métodos.
    local inner
    inner="
        export DISPLAY=${DISPLAY_NUM}
        export PULSE_SERVER=127.0.0.1
        ${tz:+export TZ='${tz}'}

        # Locale. Sem isto o LANG chega vazio na sessao e programas de TUI
        # recusam a iniciar — o btop, por exemplo, morre com
        # 'ERROR: No UTF-8 locale detected!'. O update-locale do setup grava
        # /etc/default/locale, mas nada o le automaticamente em proot.
        [ -r /etc/default/locale ] && . /etc/default/locale 2>/dev/null
        case \"\${LANG:-}\" in
            *[Uu][Tt][Ff]*) ;;              # ja e UTF-8
            *) LANG=C.UTF-8 ;;              # vazio ou sem UTF-8: fallback seguro
        esac
        # Nao basta estar configurado: precisa estar GERADO. Se o locale-gen
        # falhou, apontar LC_ALL para ele faz todo comando cuspir
        # 'setlocale: cannot change locale'. Comparamos normalizando, porque
        # o 'locale -a' imprime pt_BR.utf8 e o LANG diz pt_BR.UTF-8.
        _lxw=\$(printf '%s' \"\$LANG\" | tr 'A-Z' 'a-z' | tr -d '-')
        locale -a 2>/dev/null | tr 'A-Z' 'a-z' | tr -d '-' \\
            | grep -qxF \"\$_lxw\" || LANG=C.UTF-8
        unset _lxw
        export LANG
        export LC_ALL=\"\$LANG\"

        # SHELL. O Konsole usa esta variavel para saber o que abrir; vazia,
        # ele reclama com \"Could not find ''\" antes de cair no padrao.
        if [ -x /usr/bin/zsh ]; then export SHELL=/usr/bin/zsh
        else export SHELL=/bin/bash; fi
        export XDG_RUNTIME_DIR=/tmp/runtime-root
        mkdir -p \"\$XDG_RUNTIME_DIR\"; chmod 700 \"\$XDG_RUNTIME_DIR\"
        export QT_QPA_PLATFORM=xcb

        # O kpipewire (controles de midia e captura de tela do Plasma) tenta
        # conectar ao PipeWire, que nao existe em proot. Ele re-tenta para
        # sempre e inunda o terminal com milhares de linhas identicas.
        # Nada aqui usa PipeWire — o audio vai pelo PulseAudio.
        export QT_LOGGING_RULES='kpipewire*=false'
        ${no_picom:+export LX_NO_PICOM=1}

        case '${gpu_mode}' in
            turnip)
                export MESA_LOADER_DRIVER_OVERRIDE=kgsl
                # vblank_mode: 0 = nunca sincronizar, 3 = sempre.
                #
                # O padrao e 0, e isso e deliberado. O Termux:X11 e um servidor
                # X ANINHADO — nao existe vblank de hardware para sincronizar.
                # Forcar sincronia ali causa travadas e piscar, ainda mais
                # quando o painel do aparelho e 120 Hz e a saida (DeX/HDMI) e
                # 60 Hz: o desenho tenta se acertar com um relogio que nao e o
                # da tela final. A cadencia real quem faz e o SurfaceFlinger do
                # Android, depois de nos.
                #
                # A evidencia: com --gpu software nao havia piscar nenhum, e o
                # llvmpipe simplesmente nao faz vsync.
                case '${vsync}' in
                    on)  export vblank_mode=3; export MESA_VK_WSI_PRESENT_MODE=fifo ;;
                    *)   export vblank_mode=0; export MESA_VK_WSI_PRESENT_MODE=mailbox ;;
                esac
                ;;
            virgl)
                export GALLIUM_DRIVER=virpipe
                export MESA_GL_VERSION_OVERRIDE=4.0
                ;;
            software)
                export LIBGL_ALWAYS_SOFTWARE=1
                ;;
        esac
        dbus-launch --exit-with-session ${session_cmd}
    "

    if [ "$use_alt" -eq 1 ]; then
        # Método alternativo: o Termux-X11 sobe o display e já lança o KDE como
        # cliente via -xstartup. Alguns aparelhos acham isso mais estável.
        step "Abrindo o app Termux:X11..."
        am start --user 0 -n com.termux.x11/com.termux.x11.MainActivity >/dev/null 2>&1 \
            || info "abra o app Termux:X11 manualmente"
        sleep 2
        step "Iniciando X11 + KDE juntos (-xstartup)..."
        # shellcheck disable=SC2086
        if [ "$verbose" -eq 1 ]; then
            termux-x11 "$DISPLAY_NUM" $x11_extra \
                -xstartup "proot-distro login ${DISTRO} --shared-tmp -- /bin/bash -c $(printf '%q' "$inner")"
        else
            info "log da sessão: ${LX_LOG}"
            termux-x11 "$DISPLAY_NUM" $x11_extra \
                -xstartup "proot-distro login ${DISTRO} --shared-tmp -- /bin/bash -c $(printf '%q' "$inner")" 2>&1 \
                | grep --line-buffered -vE "$LX_NOISE" > "$LX_LOG"
        fi
    else
        step "Iniciando o servidor Termux-X11..."
        # shellcheck disable=SC2086
        termux-x11 "$DISPLAY_NUM" $x11_extra >/dev/null 2>&1 &
        sleep 3
        step "Abrindo o app Termux:X11..."
        am start --user 0 -n com.termux.x11/com.termux.x11.MainActivity >/dev/null 2>&1 \
            || info "abra o app Termux:X11 manualmente"
        sleep 2
        step "Iniciando o ${de}..."
        # A sessao grafica fala MUITO no stderr: avisos do Mesa, do dunst e
        # componentes do KDE que procuram servicos inexistentes em proot (o
        # kpipewire chega a milhares de linhas). Sem redirecionar, o terminal
        # fica inutilizavel e o usuario perde o proprio prompt.
        if [ "$verbose" -eq 1 ]; then
            proot-distro login "$DISTRO" --shared-tmp -- /bin/bash -c "$inner"
        else
            info "log da sessão: ${LX_LOG}"
            proot-distro login "$DISTRO" --shared-tmp -- /bin/bash -c "$inner" 2>&1 \
                | grep --line-buffered -vE "$LX_NOISE" > "$LX_LOG"
        fi
    fi

    echo
    local p="./lx"; have lx && p="lx"
    ok "Sessão encerrada. Rode '$p stop' para liberar memória e o wake-lock."
}

# Encerra tudo. Com "quiet" não imprime cabeçalhos (usado pelo start).
#
# Sobre os padrões [x]yz: 'pkill -f' casa contra a linha de comando inteira,
# então um pkill cujo próprio comando contenha o texto procurado se auto-mata.
# A forma [p]lasmashell não casa consigo mesma, mas casa com o processo real.
stop_everything() {
    local quiet="${1:-}"
    local p
    for p in "[s]tartplasma-x11" "[p]lasmashell" "[k]win_x11" "[k]ded" "[k]smserver" \
             "[d]bus-launch" "[d]bus-daemon"; do
        pkill -f "$p" 2>/dev/null || true
    done
    sleep 1
    pkill -f "[p]root-distro" 2>/dev/null || true
    # Casa os dois layouts do proot-distro (containers/<n>/rootfs e
    # installed-rootfs/<n>). O [p] evita que o padrão case com o próprio pkill.
    pkill -f "[c]ontainers/${DISTRO}/rootfs"   2>/dev/null || true
    pkill -f "[i]nstalled-rootfs/${DISTRO}"    2>/dev/null || true
    pkill -f "[v]irgl_test_server" 2>/dev/null || true
    pkill -f "com.termux.x11" 2>/dev/null || true
    pkill -f "termux.x11" 2>/dev/null || true
    pulseaudio --kill 2>/dev/null || true
    [ "$quiet" = "quiet" ] || true
}

cmd_stop() {
    require_termux "stop"
    header "Encerrando"
    step "Parando KDE, X11, áudio e proot..."
    stop_everything
    termux-wake-unlock 2>/dev/null || true
    ok "Tudo encerrado. Memória liberada."
}

cmd_shell() {
    require_termux "shell"
    require_ubuntu_installed
    # Mesmo tratamento de locale/fuso da sessao grafica: o proot-distro
    # sanitiza o ambiente, entao sem isto o shell nasce sem LANG.
    local tz; tz="$(getprop persist.sys.timezone 2>/dev/null)"
    exec proot-distro login "$DISTRO" --shared-tmp -- /bin/bash -lc "
        [ -r /etc/default/locale ] && . /etc/default/locale 2>/dev/null
        case \"\${LANG:-}\" in *[Uu][Tt][Ff]*) ;; *) LANG=C.UTF-8 ;; esac
        export LANG LC_ALL=\"\$LANG\"
        ${tz:+export TZ='${tz}'}
        exec \"\${SHELL:-/bin/bash}\" -l
    "
}

cmd_gpu() {
    if [ "$CTX" = "ubuntu" ]; then
        install_gpu_inside
    else
        require_termux "gpu"
        require_ubuntu_installed
        run_in_ubuntu setup-gpu && state_set gpu
    fi
}

# ===========================================================================
#  COMANDO: install / uninstall — deixa o 'lx' disponível de qualquer pasta
# ===========================================================================
#
# Usamos um symlink em vez de um alias de propósito. Um alias só existe em
# shells interativos do shell onde foi definido: não funciona dentro de
# scripts, em `sh -c`, em subshells, nem se você trocar de zsh para bash.
# O symlink num diretório do PATH funciona em todos esses casos — é o que um
# gerenciador de pacotes faria.
#
# É symlink e não cópia para que 'git pull' atualize o comando junto.

cmd_install() {
    header "Instalando o comando 'lx'"

    local src dst
    src="$(self_path)"
    dst="$(link_target)"

    [ -f "$src" ] || die "não achei o script de origem."

    if [ -e "$dst" ] || [ -L "$dst" ]; then
        local cur; cur="$(readlink -f "$dst" 2>/dev/null || echo "$dst")"
        if [ "$cur" = "$src" ]; then
            ok "já instalado em $dst"
            info "aponta para $src"
            return 0
        fi
        warn "já existe algo em $dst"
        info "aponta para: $cur"
        confirm "Substituir?" || { info "cancelado."; return 1; }
        rm -f "$dst"
    fi

    mkdir -p "$(dirname "$dst")" 2>/dev/null || true
    if ln -s "$src" "$dst" 2>/dev/null; then
        ok "symlink criado: $dst -> $src"
    else
        # Sistemas de arquivos sem suporte a symlink: copiamos, mas avisamos
        # que aí o 'git pull' não atualiza sozinho.
        warn "não consegui criar symlink — copiando o arquivo"
        install -m 755 "$src" "$dst" || die "falha ao instalar em $dst"
        warn "como é cópia, rode 'lx install' de novo após cada 'git pull'"
    fi

    echo
    if have lx; then
        ok "pronto — agora você pode rodar 'lx' de qualquer pasta"
        info "experimente: lx status"
    else
        warn "instalado, mas '$(dirname "$dst")' não parece estar no PATH"
        info "PATH atual: $PATH"
    fi
}

cmd_uninstall() {
    header "Removendo o comando 'lx'"
    local dst; dst="$(link_target)"

    if [ ! -e "$dst" ] && [ ! -L "$dst" ]; then
        info "não havia nada em $dst"
        return 0
    fi
    rm -f "$dst" && ok "removido: $dst"
    info "o repositório continua onde está — só o atalho global foi removido"
}

# Espaco em disco: o que da para recuperar sem desinstalar nada.
# Define ou mostra o ambiente padrao.
cmd_de() {
    local novo="${1:-}"

    if [ -z "$novo" ]; then
        header "Ambiente padrão"
        local atual; atual="$(read_default_de)"
        local d
        for d in kde bspwm xfce; do
            local marca="   " nota=""
            [ "$d" = "$atual" ] && marca=" * "
            if [ "$CTX" = "termux" ] && [ -d "$ROOTFS" ]; then
                case "$d" in
                    kde)   [ -x "${ROOTFS}/usr/bin/startplasma-x11" ] || nota="  (não instalado — lx setup)" ;;
                    bspwm) [ -x "${ROOTFS}/usr/bin/bspwm" ]           || nota="  (não instalado — lx rice)"  ;;
                    xfce)  [ -x "${ROOTFS}/usr/bin/startxfce4" ]      || nota="  (não instalado)"            ;;
                esac
            fi
            printf '%s%s%s%s%s\n' "$marca" "$C_BOLD" "$d" "$C_RESET" "${C_DIM}${nota}${C_RESET}"
        done
        echo
        info "para trocar:  lx de bspwm"
        info "para uma vez só, sem trocar o padrão:  lx start --de bspwm"
        return 0
    fi

    case "$novo" in
        kde|bspwm|xfce) ;;
        *) die "ambiente desconhecido: '$novo' (use: kde | bspwm | xfce)" ;;
    esac

    state_init
    printf '%s\n' "$novo" > "$DE_FILE" 2>/dev/null \
        || die "não consegui gravar em $DE_FILE"

    ok "ambiente padrão: $novo"
    info "agora 'lx start' sozinho já sobe o $novo"

    # Avisa se ainda nao esta instalado, mas nao impede — o usuario pode
    # estar definindo a preferencia antes de instalar.
    if [ "$CTX" = "termux" ] && [ -d "$ROOTFS" ]; then
        case "$novo" in
            bspwm) [ -x "${ROOTFS}/usr/bin/bspwm" ] || warn "o bspwm ainda não está instalado — rode: lx rice" ;;
            xfce)  [ -x "${ROOTFS}/usr/bin/startxfce4" ] || warn "o XFCE ainda não está instalado" ;;
            kde)   [ -x "${ROOTFS}/usr/bin/startplasma-x11" ] || warn "o KDE ainda não está instalado — rode: lx setup" ;;
        esac
    fi
}

# Mostra o log da ultima sessao grafica.
cmd_log() {
    require_termux "log"
    local f="${TMPDIR:-$PREFIX/tmp}/lx-session.log"
    [ -f "$f" ] || die "sem log ainda — rode 'lx start' primeiro."
    header "Log da última sessão"
    info "$f  ($(wc -l < "$f") linhas)"

    # Contamos por FREQUENCIA no arquivo inteiro, nao com 'uniq' simples.
    #
    # POR QUE: 'uniq' so colapsa linhas ADJACENTES iguais. Quando o ruido vem
    # em pares que se alternam (A B A B A B...), como o do kpipewire, nenhuma
    # linha e igual a sua vizinha e o uniq nao colapsa nada — foi o que
    # aconteceu na primeira versao deste comando.
    echo
    say "${C_BOLD}Linhas mais repetidas${C_RESET}"
    sort "$f" | uniq -c | sort -rn | head -8 | while read -r n resto; do
        if [ "${n:-0}" -gt 1 ] 2>/dev/null; then
            printf '  %s%5sx%s %s\n' "$C_YEL" "$n" "$C_RESET" "$(printf '%.100s' "$resto")"
        fi
    done

    echo
    say "${C_BOLD}Últimas linhas não-repetitivas${C_RESET}"
    # Remove o que aparece mais de 3 vezes: sobra o que e de fato singular.
    local repetidas
    repetidas="$(sort "$f" | uniq -c | awk '$1 > 3 {$1=""; print substr($0,2)}')"
    if [ -n "$repetidas" ]; then
        grep -vxF "$repetidas" "$f" 2>/dev/null | tail -25 | sed 's/^/  /'
    else
        tail -25 "$f" | sed 's/^/  /'
    fi

    # O bspwmrc registra os passos num arquivo separado, dentro do container.
    # Com --shared-tmp o /tmp de la e este mesmo diretorio.
    local bl="${TMPDIR:-$PREFIX/tmp}/lx-bspwm.log"
    if [ -f "$bl" ]; then
        echo
        say "${C_BOLD}Sessão bspwm${C_RESET}  ${C_DIM}($bl)${C_RESET}"
        sed 's/^/  /' "$bl" | tail -30
    fi

    echo
    info "log completo:  cat $f"
}

# Diagnostico completo em texto puro, para copiar e colar.
#
# Existe para evitar idas e vindas de captura de tela: uma execucao mostra
# versoes, estado, caminhos, o que esta rodando e o resumo do log — com data
# e hora, para nao haver duvida se a informacao e da sessao atual.
cmd_report() {
    require_termux "report"
    local f="${TMPDIR:-$PREFIX/tmp}/lx-session.log"

    # Sem cor: a saida e para colar em texto.
    C_RESET=""; C_BOLD=""; C_DIM=""; C_RED=""; C_GRN=""; C_YEL=""; C_BLU=""; C_CYN=""

    echo "===== lx report ====="
    echo "data:      $(date '+%Y-%m-%d %H:%M:%S %Z')"
    echo "lx:        v${LX_VERSION}  ($(self_path))"
    echo "commit:    $(git -C "$(repo_dir)" rev-parse --short HEAD 2>/dev/null || echo '?')"
    echo "contexto:  ${CTX}"
    echo "android:   $(getprop ro.build.version.release 2>/dev/null || echo '?')  \
modelo $(getprop ro.product.model 2>/dev/null || echo '?')"
    resolve_rootfs
    echo "rootfs:    ${ROOTFS}"
    echo "padrão de: $(read_default_de)"
    echo

    echo "--- distro no container ---"
    if [ -r "${ROOTFS}/etc/os-release" ]; then
        grep -E '^(PRETTY_NAME|VERSION_CODENAME)=' "${ROOTFS}/etc/os-release" || true
    else
        echo "(sem /etc/os-release)"
    fi
    echo

    echo "--- binários de sessão ---"
    local b
    for b in startplasma-x11 startplasma-wayland bspwm sxhkd polybar rofi picom kitty xsetroot feh dunst; do
        printf '%-22s %s\n' "$b" "$([ -x "${ROOTFS}/usr/bin/$b" ] && echo presente || echo AUSENTE)"
    done
    echo

    echo "--- processos agora ---"
    for b in termux-x11 startplasma-x11 bspwm polybar picom pulseaudio proot; do
        # 'pgrep -c' ja imprime 0 e sai com codigo 1 quando nao acha nada; o
        # '|| echo 0' antigo duplicava a saida e quebrava o alinhamento.
        printf '%-18s %s\n' "$b" "$(pgrep -c -f "[${b:0:1}]${b:1}" 2>/dev/null | head -1)"
    done
    echo

    echo "--- espaço ---"
    df -h "$PREFIX" 2>/dev/null | tail -1
    echo

    echo "--- log da sessão ---"
    if [ -f "$f" ]; then
        echo "arquivo: $f ($(wc -l < "$f") linhas, modificado $(date -r "$f" '+%H:%M:%S' 2>/dev/null || echo '?'))"
        echo "* linhas mais repetidas:"
        sort "$f" | uniq -c | sort -rn | head -5 | sed 's/^/    /'
        echo "* últimas 20 linhas:"
        tail -20 "$f" | sed 's/^/    /'
    else
        echo "(sem log — rode 'lx start' primeiro)"
    fi

    local bl="${TMPDIR:-$PREFIX/tmp}/lx-bspwm.log"
    echo "--- sessão bspwm ---"
    if [ -f "$bl" ]; then cat "$bl" | sed 's/^/    /'; else echo "(sem log de bspwm)"; fi
    echo "===== fim ====="
}

cmd_clean() {
    header "Liberando espaço"

    if [ "$CTX" = "termux" ]; then
        require_ubuntu_installed
        step "Cache de pacotes do Termux..."
        apt clean 2>/dev/null || pkg clean 2>/dev/null || true

        step "Cache de pacotes do Ubuntu..."
        proot-distro login "$DISTRO" -- /bin/bash -c \
            'du -sh /var/cache/apt/archives 2>/dev/null; apt clean' 2>/dev/null || true

        step "Cache de imagens do proot-distro..."
        # Camadas OCI baixadas na instalacao; nao sao necessarias depois.
        rm -rf "${PREFIX}/var/lib/proot-distro/cache"/* 2>/dev/null || true

        echo
        step "Espaço agora:"
        df -h "$PREFIX" 2>/dev/null | tail -1 | sed 's/^/     /'
    else
        step "Cache de pacotes..."
        apt clean
        df -h / | tail -1 | sed 's/^/     /'
    fi

    ok "Pronto."
}

cmd_update() {
    header "Atualizando"

    # Se estivermos dentro do repositório git, atualiza o próprio lx primeiro.
    # Como 'install' cria um symlink, o comando global acompanha automaticamente.
    local rd; rd="$(repo_dir)"
    if [ -d "$rd/.git" ] && have git; then
        step "Atualizando o repositório..."
        git -C "$rd" pull --ff-only 2>&1 | sed 's/^/     /' \
            || warn "git pull falhou (seguindo com os pacotes)"
    fi

    if [ "$CTX" = "termux" ]; then
        step "Pacotes do Termux..."; pkg update -y && pkg upgrade -y
        if [ -d "$ROOTFS" ]; then
            step "Pacotes do Ubuntu..."
            proot-distro login "$DISTRO" -- /bin/bash -c \
                "export DEBIAN_FRONTEND=noninteractive; apt update && apt upgrade -y"
        fi
    else
        export DEBIAN_FRONTEND=noninteractive
        apt update && apt upgrade -y
    fi
    ok "Atualizado."
}

# ===========================================================================
#  Menu interativo
# ===========================================================================

cmd_menu() {
    while true; do
        clear 2>/dev/null || true
        printf '%s\n' "$C_BOLD$C_CYN"
        cat <<'BANNER'
    _
  | |_  __
  | | \/  |   linux-android
  |_|_/\__|   Linux com KDE / bspwm no Android
BANNER
        printf '%s' "$C_RESET"
        say "  v${LX_VERSION} · ${LX_AUTHOR} · contexto: ${CTX}"
        echo

        local feitas=0 k
        for k in termux ubuntu kde gpu dev-termux dev-ubuntu; do
            state_has "$k" && feitas=$((feitas+1))
        done
        info "instalação: ${feitas}/6 etapas · ambiente padrão: $(read_default_de)"
        echo

        say "  ${C_DIM}INSTALAR${C_RESET}"
        say "    ${C_BOLD}1${C_RESET})  Instalar tudo               ${C_DIM}setup${C_RESET}"
        say "    ${C_BOLD}2${C_RESET})  Ambiente de desenvolvimento ${C_DIM}dev${C_RESET}"
        say "    ${C_BOLD}3${C_RESET})  Aceleração de GPU           ${C_DIM}gpu${C_RESET}"
        say "    ${C_BOLD}4${C_RESET})  Navegador                   ${C_DIM}browser${C_RESET}"
        say "    ${C_BOLD}5${C_RESET})  Desktop rice (bspwm)        ${C_DIM}rice${C_RESET}"
        say "    ${C_BOLD}v${C_RESET})  VS Code                     ${C_DIM}vscode${C_RESET}"
        echo
        say "  ${C_DIM}USAR${C_RESET}"
        say "    ${C_BOLD}6${C_RESET})  Iniciar o desktop           ${C_DIM}start${C_RESET}"
        say "    ${C_BOLD}7${C_RESET})  Parar o desktop             ${C_DIM}stop${C_RESET}"
        say "    ${C_BOLD}8${C_RESET})  Escolher ambiente padrão    ${C_DIM}de${C_RESET}"
        say "    ${C_BOLD}9${C_RESET})  Terminal do Ubuntu          ${C_DIM}shell${C_RESET}"
        echo
        say "  ${C_DIM}MANUTENÇÃO${C_RESET}"
        say "    ${C_BOLD}d${C_RESET})  Diagnóstico                 ${C_DIM}doctor${C_RESET}"
        say "    ${C_BOLD}s${C_RESET})  Status das etapas           ${C_DIM}status${C_RESET}"
        say "    ${C_BOLD}l${C_RESET})  Log da última sessão        ${C_DIM}log${C_RESET}"
        say "    ${C_BOLD}r${C_RESET})  Relatório para colar        ${C_DIM}report${C_RESET}"
        say "    ${C_BOLD}u${C_RESET})  Atualizar tudo              ${C_DIM}update${C_RESET}"
        say "    ${C_BOLD}c${C_RESET})  Liberar espaço              ${C_DIM}clean${C_RESET}"
        if have lx; then
            say "    ${C_DIM}i)  comando 'lx' já instalado${C_RESET}"
        else
            say "    ${C_BOLD}i${C_RESET})  Usar 'lx' de qualquer pasta ${C_DIM}install${C_RESET}"
        fi
        echo
        say "    ${C_BOLD}0${C_RESET})  Sair"
        echo
        printf '%sEscolha:%s ' "$C_BOLD" "$C_RESET"
        local escolha; read -r escolha

        case "$escolha" in
            1) cmd_setup ;;
            2) menu_dev ;;
            3) cmd_gpu ;;
            4) menu_browser ;;
            5) menu_rice ;;
            v|V) cmd_vscode ;;
            6) cmd_start ;;
            7) cmd_stop ;;
            8) menu_de ;;
            9) cmd_shell ;;
            d|D) cmd_doctor ;;
            s|S) cmd_status ;;
            l|L) cmd_log ;;
            r|R) cmd_report ;;
            u|U) cmd_update ;;
            c|C) cmd_clean ;;
            i|I) cmd_install ;;
            0|q|Q) exit 0 ;;
            *) warn "opção inválida" ;;
        esac

        echo
        printf '%sEnter para voltar ao menu...%s' "$C_DIM" "$C_RESET"
        read -r _
    done
}

menu_rice() {
    header "Desktop rice — bspwm + Catppuccin Mocha"
    say "  Instala bspwm, sxhkd, polybar, rofi, picom, kitty e dunst,"
    say "  com a fonte JetBrainsMono Nerd e a paleta Catppuccin Mocha."
    echo
    say "  Escolha o modificador dos atalhos:"
    echo
    say "    ${C_BOLD}1${C_RESET})  alt        ${C_DIM}recomendado no Samsung DeX${C_RESET}"
    say "    ${C_BOLD}2${C_RESET})  super      ${C_DIM}tecla Windows — NÃO funciona no DeX${C_RESET}"
    say "    ${C_BOLD}3${C_RESET})  ctrl+alt   ${C_DIM}se o alt conflitar com algum programa${C_RESET}"
    say "    ${C_BOLD}0${C_RESET})  Voltar"
    echo
    info "o DeX reserva a tecla Super no sistema e não há como desativar"
    echo
    printf '%sEscolha:%s ' "$C_BOLD" "$C_RESET"
    local c; read -r c
    case "$c" in
        1) cmd_rice --mod alt ;;
        2) cmd_rice --mod super ;;
        3) cmd_rice --mod ctrl-alt ;;
        *) return 0 ;;
    esac
}

menu_de() {
    header "Ambiente padrão do 'start'"
    cmd_de
    echo
    say "    ${C_BOLD}1${C_RESET})  kde        ${C_DIM}completo, funciona com toque${C_RESET}"
    say "    ${C_BOLD}2${C_RESET})  bspwm      ${C_DIM}tiling, precisa de teclado${C_RESET}"
    say "    ${C_BOLD}3${C_RESET})  xfce       ${C_DIM}leve${C_RESET}"
    say "    ${C_BOLD}0${C_RESET})  Voltar"
    echo
    printf '%sEscolha:%s ' "$C_BOLD" "$C_RESET"
    local c; read -r c
    case "$c" in
        1) cmd_de kde ;;
        2) cmd_de bspwm ;;
        3) cmd_de xfce ;;
        *) return 0 ;;
    esac
}

menu_browser() {
    header "Navegador"
    say "  O 'firefox' e o 'chromium' do Ubuntu são pacotes de transição para"
    say "  snap, que não roda em proot. Estas opções realmente funcionam:"
    echo
    say "  ${C_BOLD}1${C_RESET})  Firefox  ${C_DIM}(.deb oficial da Mozilla)${C_RESET}"
    say "  ${C_BOLD}2${C_RESET})  Falkon   ${C_DIM}(Qt/KDE, bem mais leve)${C_RESET}"
    say "  ${C_BOLD}0${C_RESET})  Voltar"
    echo
    printf '%sEscolha:%s ' "$C_BOLD" "$C_RESET"
    local c; read -r c
    case "$c" in
        1) cmd_browser firefox ;;
        2) cmd_browser falkon ;;
        *) return 0 ;;
    esac
}

menu_dev() {
    header "Ambiente de desenvolvimento"
    say "  Instala: zsh + oh-my-zsh (darkblood), NvChad, tmux, git,"
    say "           btop, bat, fzf, lazygit, fastfetch e Claude Code."
    echo
    say "  ${C_BOLD}1${C_RESET})  Nos dois (Termux + Ubuntu)   ${C_DIM}recomendado${C_RESET}"
    say "  ${C_BOLD}2${C_RESET})  Só no Termux"
    say "  ${C_BOLD}3${C_RESET})  Só no Ubuntu"
    say "  ${C_BOLD}0${C_RESET})  Voltar"
    echo
    printf '%sEscolha:%s ' "$C_BOLD" "$C_RESET"
    local c; read -r c
    case "$c" in
        1) cmd_dev both ;;
        2) cmd_dev termux ;;
        3) cmd_dev ubuntu ;;
        *) return 0 ;;
    esac
}

# ===========================================================================
#  Ajuda
# ===========================================================================

cmd_help() {
    cat <<EOF
${C_BOLD}lx${C_RESET} v${LX_VERSION} — gerenciador do projeto linux-android
por ${LX_AUTHOR}

${C_BOLD}USO${C_RESET}
    ./lx                    menu interativo
    ./lx <comando> [opções]

${C_BOLD}COMANDOS${C_RESET}
    ${C_BOLD}setup${C_RESET}               Instala tudo: Termux, Ubuntu, KDE e GPU.
                        Pula o que já está feito — pode rodar de novo.

    ${C_BOLD}start${C_RESET} [opções]      Inicia o desktop.
        --de AMBIENTE     kde (padrão) | bspwm | xfce
        --gpu MODO        auto (padrão) | turnip | virgl | software
        --alt             método alternativo (-xstartup), se o normal falhar
        --no-picom        inicia sem o compositor (isola problemas de
                          renderização — tela preta com tudo rodando)
        --vsync on|off    sincronização vertical (padrão: off).
                          Deixe 'off': o Termux:X11 é um X aninhado, sem
                          vblank de hardware, e forçar sincronia causa
                          travadas e piscar — sobretudo com painel de
                          120 Hz e saída externa de 60 Hz.
        -v, --verbose     mostra a saída da sessão no terminal em vez de
                          mandar para o log (útil para diagnosticar)
        --extra "FLAGS"   flags do termux-x11:
                            -legacy-drawing   tela preta
                            -force-bgra       cores trocadas
                            -dpi 96           ajuste de tamanho do texto

    ${C_BOLD}stop${C_RESET}                Encerra o desktop e libera memória.

    ${C_BOLD}dev${C_RESET} [alvo]          Ambiente de desenvolvimento.
                        alvo: both (padrão) | termux | ubuntu
        --no-claude       não instalar o Claude Code

                        Instala: zsh + oh-my-zsh (tema darkblood), NvChad,
                        tmux, git, btop, bat, fzf, lazygit, fastfetch e
                        Claude Code.

                        O Claude Code é instalado DENTRO do Ubuntu, com o
                        instalador oficial do npm. No Termux nativo ele não
                        roda: é um binário linkado com glibc e o Android usa
                        bionic libc. O comando 'claude' fica disponível no
                        Termux por um wrapper que executa no Ubuntu.

    ${C_BOLD}gpu${C_RESET}                 Ativa a aceleração de GPU (Turnip/Adreno).

    ${C_BOLD}de${C_RESET} [ambiente]       Mostra ou define o ambiente padrão do 'start'.
                        Sem argumento, lista os três e marca o atual.
                        Ex.: 'lx de bspwm' faz o 'lx start' subir o bspwm
                        sem precisar da flag toda vez.

    ${C_BOLD}rice${C_RESET} [--mod X]      Instala um desktop "rice": bspwm + sxhkd, polybar,
                        rofi, picom (cantos arredondados e transparência),
                        kitty, dunst e a fonte JetBrainsMono Nerd, tudo com
                        a paleta Catppuccin Mocha.
                        --mod super | alt | ctrl-alt  (padrão: super)
                        No Samsung DeX use 'alt': o DeX intercepta a
                        tecla Super no sistema e não há como desativar.

                        Depois:  lx start --de bspwm

    ${C_BOLD}vscode${C_RESET}              Instala o VS Code (repo oficial da Microsoft, arm64)
                        e desativa o sandbox do Electron, que não funciona
                        em proot. Cria o wrapper 'code-proot'.

    ${C_BOLD}browser${C_RESET} [qual]      Instala um navegador que REALMENTE roda em proot.
                        qual: firefox (padrão) | falkon

                        O 'firefox'/'chromium' do Ubuntu são pacotes de
                        transição para snap, e snap não funciona em proot.
                        Este comando usa o repositório .deb oficial da
                        Mozilla e desativa o sandbox, que precisa de
                        namespaces indisponíveis aqui.

    ${C_BOLD}doctor${C_RESET}              Diagnostica o que está faltando ou errado.
    ${C_BOLD}status${C_RESET}              Mostra quais etapas já foram concluídas.
    ${C_BOLD}shell${C_RESET}               Abre um terminal dentro do Ubuntu.
    ${C_BOLD}update${C_RESET}              Atualiza o repositório e os pacotes dos dois ambientes.
    ${C_BOLD}report${C_RESET}              Diagnóstico completo em texto puro, com data e hora.
                        Feito para copiar e colar ao pedir ajuda.

    ${C_BOLD}log${C_RESET}                 Mostra o log da última sessão, colapsando as
                        linhas repetidas.

    ${C_BOLD}clean${C_RESET}               Libera espaço: caches de pacotes e camadas OCI baixadas.

    ${C_BOLD}install${C_RESET}             Deixa o 'lx' disponível de qualquer pasta.
                        Cria um symlink em \$PREFIX/bin (não é um alias: também
                        funciona dentro de scripts, subshells e outros shells).
                        Como é symlink, 'git pull' já atualiza o comando.
    ${C_BOLD}uninstall${C_RESET}           Remove esse atalho (o repositório fica).

    ${C_BOLD}help${C_RESET}                Esta ajuda.

${C_BOLD}EXEMPLOS${C_RESET}
    ./lx install                        habilitar o comando 'lx' global
    lx setup                            (depois disso, de qualquer pasta)
    ./lx start                          iniciar (GPU automática)
    ./lx start --gpu software           iniciar sem GPU (diagnóstico)
    ./lx start --extra "-force-bgra"    corrigir cores invertidas
    ./lx dev termux                     só o ambiente dev do Termux

${C_BOLD}AUTOR${C_RESET}
    ${LX_AUTHOR} · https://github.com/NicolasArthurDev
    Licença MIT.

${C_BOLD}DOCUMENTAÇÃO${C_RESET}
    docs/01-pre-requisitos.md     apps e opções do Android (leia primeiro)
    docs/06-monitor-externo.md    usar num monitor via hub USB-C
    docs/07-aceleracao-gpu.md     detalhes e diagnóstico de GPU
    ${REPO_URL}
EOF
}

# ===========================================================================
#  Dispatch
# ===========================================================================

main() {
    state_init

    local cmd="${1:-}"
    [ $# -gt 0 ] && shift

    case "$cmd" in
        ""|menu)          cmd_menu ;;
        setup)            cmd_setup ;;
        start|iniciar)    cmd_start "$@" ;;
        stop|parar)       cmd_stop ;;
        dev)              cmd_dev "$@" ;;
        gpu)              cmd_gpu ;;
        browser|navegador) cmd_browser "$@" ;;
        rice)             cmd_rice "$@" ;;
        vscode|code)      cmd_vscode ;;
        doctor|diag)      cmd_doctor ;;
        status)           cmd_status ;;
        shell|ubuntu)     cmd_shell ;;
        update)           cmd_update ;;
        clean|limpar)     cmd_clean ;;
        log|logs)         cmd_log ;;
        report|relatorio) cmd_report ;;
        de|ambiente)      cmd_de "$@" ;;
        install)          cmd_install ;;
        uninstall)        cmd_uninstall ;;
        help|-h|--help)   cmd_help ;;
        version|--version|where)
            say "lx v${LX_VERSION} — ${LX_AUTHOR}"
            say "arquivo:  $(self_path)"
            say "invocado: ${BASH_SOURCE[0]}"
            say "contexto: ${CTX}"
            ;;

        # Subcomandos internos, usados quando o script se re-invoca no Ubuntu.
        setup-kde)        install_kde_inside ;;
        setup-gpu)        install_gpu_inside ;;
        browser-install)  install_browser_inside "$@" ;;
        rice-install)     install_rice_inside "$@" ;;
        vscode-install)   install_vscode_inside ;;

        *) err "comando desconhecido: '$cmd'"; echo; cmd_help; exit 1 ;;
    esac
}

main "$@"