Upload 5 files

.gitattributes

@@ -33,3 +33,4 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+LOGO_ADVISION_AI_TRANSPARENTE.png filter=lfs diff=lfs merge=lfs -text

README.md

@@ -1,20 +1,140 @@
----
-title: Libretranslate Prodoc
-emoji: 🚀
-colorFrom: red
-colorTo: red
-sdk: docker
-app_port: 8501
-tags:
-- streamlit
+\---
+
+title: LibreTranslate ProDoc
+emoji: 🌐
+colorFrom: blue
+colorTo: purple
+sdk: streamlit
+sdk\_version: "1.35.0"
+app\_file: app.py
 pinned: false
-short_description: 'Traduce documentos de PDF y Word desde y a cualquier idioma '
-license: other
----
+license: mit
+short\_description: Traduce PDF y Word offline manteniendo el diseño original
+tags:
+
+* translation
+* pdf
+* docx
+* argos-translate
+* offline
+* document-processing
+
+\---
+
+# 🌐 LibreTranslate ProDoc
+
+> \*\*Traducción offline de documentos PDF y Word con preservación de diseño.\*\*  
+> Motor: \[Argos Translate](https://github.com/argosopentech/argos-translate) · Desarrollado por AdVision AI
+
+\---
+
+## ✨ Características Principales
+
+|Característica|Detalle|
+|-|-|
+|📄 **Formatos**|PDF (vía PyMuPDF) y DOCX (vía python-docx)|
+|🔒 **Privacidad**|100% offline, tus documentos no salen del servidor|
+|🎨 **Diseño**|Preserva layout, fuentes, negritas, cursivas y tablas|
+|🗑️ **Seguridad**|Auto-limpieza: archivos eliminados a los 5 minutos|
+|🌍 **Idiomas**|20 idiomas: EN, ES, FR, DE, IT, PT, ZH, JA, KO, RU...|
+|⚡ **Lazy Loading**|Los modelos se descargan solo cuando los necesitas|
+
+\---
+
+## 🚀 Cómo Usar la App
+
+1. **Selecciona los idiomas** en la barra lateral izquierda
+
+   * Idioma Origen: el idioma del documento original
+   * Idioma Destino: el idioma al que quieres traducir
+2. **Carga tu documento** en el área central
+
+   * Arrastra el archivo o haz clic en "Browse files"
+   * Formatos aceptados: `.pdf` · `.docx`
+   * Tamaño máximo: 50 MB
+3. **Haz clic en "Traducir Documento"**
+
+   * La primera vez, descargará el modelo de idioma (\~150MB)
+   * Las siguientes veces será instantáneo (usa el caché)
+4. **Descarga el resultado**
+
+   * Aparecerá un botón de descarga con el documento traducido
+   * El archivo se eliminará del servidor en 5 minutos automáticamente
+
+\---
+
+## 🌍 Idiomas Soportados
+
+|Código|Idioma|Código|Idioma|
+|-|-|-|-|
+|`en`|🇺🇸 Inglés|`zh`|🇨🇳 Chino|
+|`es`|🇪🇸 Español|`ja`|🇯🇵 Japonés|
+|`fr`|🇫🇷 Francés|`ko`|🇰🇷 Coreano|
+|`de`|🇩🇪 Alemán|`tr`|🇹🇷 Turco|
+|`it`|🇮🇹 Italiano|`sv`|🇸🇪 Sueco|
+|`pt`|🇵🇹 Portugués|`da`|🇩🇰 Danés|
+|`nl`|🇳🇱 Neerlandés|`fi`|🇫🇮 Finlandés|
+|`pl`|🇵🇱 Polaco|`nb`|🇳🇴 Noruego|
+|`ru`|🇷🇺 Ruso|`cs`|🇨🇿 Checo|
+|`ar`|🇸🇦 Árabe|`hu`|🇭🇺 Húngaro|
+
+\---
+
+## ⚙️ Arquitectura Técnica
+
+```
+┌─────────────────────────────────────────┐
+│          LibreTranslate ProDoc          │
+│              (Streamlit UI)             │
+└──────────────────┬──────────────────────┘
+                   │
+        ┌──────────┴──────────┐
+        │                     │
+   ┌────▼────┐          ┌─────▼─────┐
+   │  PDF    │          │   DOCX    │
+   │PyMuPDF  │          │python-docx│
+   └────┬────┘          └─────┬─────┘
+        │                     │
+        └──────────┬──────────┘
+                   │
+          ┌────────▼────────┐
+          │ Argos Translate  │
+          │  (Offline NMT)   │
+          └────────┬─────────┘
+                   │
+          ┌────────▼─────────┐
+          │  Auto-Cleanup    │
+          │ threading.Timer  │
+          │   (5 minutos)    │
+          └──────────────────┘
+```
+
+\---
+
+## ⚠️ Limitaciones Conocidas
+
+* **PDFs escaneados (imágenes):** El motor extrae texto digital. Los PDFs que son imágenes escaneadas sin OCR no pueden ser procesados.
+* **Fuentes personalizadas:** Si el PDF usa fuentes muy específicas no instaladas en el servidor, el texto traducido usará una fuente de respaldo estándar.
+* **Textos muy largos:** Los documentos muy extensos (>200 páginas) pueden tardar varios minutos. Ten paciencia.
+* **Longitud del texto:** El texto traducido puede ser más largo/corto que el original, lo que puede afectar el layout en PDFs muy ajustados.
+
+\---
+
+## 📄 Licencia
+
+MIT License — Libre para uso personal y comercial con atribución.
+
+\---
+
+## 💙 Créditos
+
+* [**Argos Translate**](https://github.com/argosopentech/argos-translate) — Motor de traducción NMT offline
+* [**PyMuPDF**](https://pymupdf.readthedocs.io/) — Procesamiento de PDFs
+* [**python-docx**](https://python-docx.readthedocs.io/) — Procesamiento de Word
+* [**Streamlit**](https://streamlit.io/) — Framework de UI
+* **AdVision AI** — Diseño y desarrollo
 
-# Welcome to Streamlit!
+\---
 
-Edit `/src/streamlit_app.py` to customize this app to your heart's desire. :heart:
+*¿Te resulta útil? ¡Apóyanos con una donación vía* [*PayPal*](https://www.paypal.me/TU_USUARIO_AQUI) *o contáctanos por* [*WhatsApp*](https://wa.me/521XXXXXXXXXX)*!*
 
-If you have any questions, checkout our [documentation](https://docs.streamlit.io) and [community
-forums](https://discuss.streamlit.io).

app.py

@@ -0,0 +1,1448 @@
+# =============================================================================
+# LibreTranslate ProDoc — app.py
+# Desarrollado para Hugging Face Spaces (SDK: Streamlit)
+# Motor de traducción: Argos Translate (100% offline)
+# Autor: AdVision AI  |  Versión: 1.0.0
+# =============================================================================
+# DESCRIPCIÓN GENERAL:
+#   Aplicación que traduce archivos PDF y DOCX manteniendo el diseño original.
+#   Utiliza Argos Translate para funcionar sin conexión a internet una vez
+#   descargados los modelos de idioma.
+# =============================================================================
+
+import streamlit as st
+import os
+import sys
+import time
+import threading
+import tempfile
+import shutil
+import logging
+from pathlib import Path
+from datetime import datetime
+
+# ─── Configuración de logging ──────────────────────────────────────────────────
+logging.basicConfig(
+    level=logging.INFO,
+    format="%(asctime)s [%(levelname)s] %(message)s"
+)
+logger = logging.getLogger(__name__)
+
+# ─── CONFIGURACIÓN DE PÁGINA (DEBE IR PRIMERO) ─────────────────────────────────
+st.set_page_config(
+    page_title="LibreTranslate ProDoc",
+    page_icon="🌐",
+    layout="wide",
+    initial_sidebar_state="expanded",
+)
+
+# =============================================================================
+# SECCIÓN 1: INYECCIÓN DE CSS PERSONALIZADO
+# Paleta de colores extraída del logotipo AdVision AI:
+#   - Fondo principal: #0a0a0f (negro profundo)
+#   - Cian eléctrico:  #00e5ff
+#   - Azul vibrante:   #3d5afe
+#   - Violeta:         #9c27b0
+#   - Magenta:         #e91e8c
+# =============================================================================
+CUSTOM_CSS = """
+<style>
+/* ── Importar fuentes de Google Fonts ─────────────────────────────────────── */
+@import url('https://fonts.googleapis.com/css2?family=Exo+2:wght@300;400;600;700;900&family=Space+Mono:wght@400;700&display=swap');
+
+/* ── Variables CSS globales ───────────────────────────────────────────────── */
+:root {
+    --bg-primary:    #0a0a0f;
+    --bg-secondary:  #12121a;
+    --bg-card:       #1a1a2e;
+    --cyan:          #00e5ff;
+    --blue:          #3d5afe;
+    --violet:        #9c27b0;
+    --magenta:       #e91e8c;
+    --white:         #f0f0f5;
+    --gray:          #8888aa;
+    --gradient-main: linear-gradient(135deg, #00e5ff 0%, #3d5afe 35%, #9c27b0 65%, #e91e8c 100%);
+    --gradient-glow: linear-gradient(135deg, rgba(0,229,255,0.15) 0%, rgba(233,30,140,0.15) 100%);
+    --radius-lg:     16px;
+    --radius-md:     10px;
+    --radius-sm:     6px;
+    --shadow-glow:   0 0 30px rgba(0,229,255,0.12), 0 0 60px rgba(156,39,176,0.08);
+}
+
+/* ── Reset general de Streamlit ───────────────────────────────────────────── */
+html, body, [data-testid="stAppViewContainer"] {
+    background-color: var(--bg-primary) !important;
+    font-family: 'Exo 2', sans-serif !important;
+    color: var(--white) !important;
+}
+
+/* ── Fondo con patrón de cuadrícula sutil ─────────────────────────────────── */
+[data-testid="stAppViewContainer"]::before {
+    content: "";
+    position: fixed;
+    top: 0; left: 0; right: 0; bottom: 0;
+    background-image:
+        linear-gradient(rgba(0,229,255,0.03) 1px, transparent 1px),
+        linear-gradient(90deg, rgba(0,229,255,0.03) 1px, transparent 1px);
+    background-size: 40px 40px;
+    pointer-events: none;
+    z-index: 0;
+}
+
+/* ── Sidebar ──────────────────────────────────────────────────────────────── */
+[data-testid="stSidebar"] {
+    background: var(--bg-secondary) !important;
+    border-right: 1px solid rgba(0,229,255,0.15) !important;
+    box-shadow: 4px 0 20px rgba(0,0,0,0.4) !important;
+}
+
+[data-testid="stSidebar"] * {
+    color: var(--white) !important;
+}
+
+/* ── Título principal con degradado ──────────────────────────────────────── */
+.app-title {
+    font-family: 'Exo 2', sans-serif;
+    font-weight: 900;
+    font-size: 2.6rem;
+    background: var(--gradient-main);
+    -webkit-background-clip: text;
+    -webkit-text-fill-color: transparent;
+    background-clip: text;
+    text-align: center;
+    letter-spacing: -0.5px;
+    margin-bottom: 0.2rem;
+}
+
+.app-subtitle {
+    font-family: 'Space Mono', monospace;
+    font-size: 0.78rem;
+    color: var(--cyan);
+    text-align: center;
+    letter-spacing: 3px;
+    text-transform: uppercase;
+    opacity: 0.7;
+    margin-bottom: 1.5rem;
+}
+
+/* ── Contenedores / cards ─────────────────────────────────────────────────── */
+.pro-card {
+    background: var(--bg-card);
+    border: 1px solid rgba(0,229,255,0.12);
+    border-radius: var(--radius-lg);
+    padding: 1.8rem;
+    margin: 1rem 0;
+    box-shadow: var(--shadow-glow);
+    position: relative;
+    overflow: hidden;
+    transition: border-color 0.3s ease;
+}
+
+.pro-card::before {
+    content: "";
+    position: absolute;
+    top: 0; left: 0; right: 0;
+    height: 2px;
+    background: var(--gradient-main);
+    border-radius: var(--radius-lg) var(--radius-lg) 0 0;
+}
+
+.pro-card:hover {
+    border-color: rgba(0,229,255,0.3);
+}
+
+/* ── Separador con degradado ──────────────────────────────────────────────── */
+.gradient-divider {
+    height: 1px;
+    background: var(--gradient-main);
+    margin: 1.2rem 0;
+    opacity: 0.4;
+    border: none;
+}
+
+/* ── Etiquetas de sección ─────────────────────────────────────────────────── */
+.section-label {
+    font-family: 'Space Mono', monospace;
+    font-size: 0.68rem;
+    color: var(--cyan);
+    letter-spacing: 2.5px;
+    text-transform: uppercase;
+    margin-bottom: 0.6rem;
+    opacity: 0.85;
+}
+
+/* ── Badge de estado ──────────────────────────────────────────────────────── */
+.status-badge {
+    display: inline-flex;
+    align-items: center;
+    gap: 6px;
+    padding: 4px 12px;
+    border-radius: 20px;
+    font-size: 0.75rem;
+    font-weight: 600;
+    font-family: 'Space Mono', monospace;
+}
+
+.status-badge.ready {
+    background: rgba(0,229,255,0.12);
+    border: 1px solid rgba(0,229,255,0.3);
+    color: var(--cyan);
+}
+
+.status-badge.processing {
+    background: rgba(156,39,176,0.15);
+    border: 1px solid rgba(156,39,176,0.4);
+    color: #ce93d8;
+}
+
+.status-badge.success {
+    background: rgba(76,175,80,0.12);
+    border: 1px solid rgba(76,175,80,0.35);
+    color: #a5d6a7;
+}
+
+.status-badge.error {
+    background: rgba(244,67,54,0.12);
+    border: 1px solid rgba(244,67,54,0.35);
+    color: #ef9a9a;
+}
+
+/* ── Botones de Streamlit ─────────────────────────────────────────────────── */
+.stButton > button {
+    background: var(--gradient-main) !important;
+    color: #000 !important;
+    font-family: 'Exo 2', sans-serif !important;
+    font-weight: 700 !important;
+    font-size: 0.95rem !important;
+    border: none !important;
+    border-radius: var(--radius-md) !important;
+    padding: 0.65rem 2rem !important;
+    letter-spacing: 0.5px !important;
+    transition: all 0.3s ease !important;
+    box-shadow: 0 4px 20px rgba(0,229,255,0.25) !important;
+}
+
+.stButton > button:hover {
+    transform: translateY(-2px) !important;
+    box-shadow: 0 8px 30px rgba(0,229,255,0.4) !important;
+}
+
+.stButton > button:active {
+    transform: translateY(0) !important;
+}
+
+/* ── Selectbox y otros widgets ────────────────────────────────────────────── */
+.stSelectbox > div > div {
+    background: var(--bg-card) !important;
+    border: 1px solid rgba(0,229,255,0.2) !important;
+    border-radius: var(--radius-sm) !important;
+    color: var(--white) !important;
+}
+
+/* ── Progress bar ─────────────────────────────────────────────────────────── */
+.stProgress > div > div > div {
+    background: var(--gradient-main) !important;
+    border-radius: 4px !important;
+}
+
+/* ── File uploader ────────────────────────────────────────────────────────── */
+[data-testid="stFileUploader"] {
+    background: rgba(0,229,255,0.03) !important;
+    border: 2px dashed rgba(0,229,255,0.25) !important;
+    border-radius: var(--radius-lg) !important;
+    transition: all 0.3s ease !important;
+}
+
+[data-testid="stFileUploader"]:hover {
+    border-color: rgba(0,229,255,0.5) !important;
+    background: rgba(0,229,255,0.06) !important;
+}
+
+/* ── Texto de info/warning/error ──────────────────────────────────────────── */
+.stAlert {
+    border-radius: var(--radius-md) !important;
+    border: 1px solid rgba(0,229,255,0.15) !important;
+}
+
+/* ── Sidebar botón de PayPal ──────────────────────────────────────────────── */
+.paypal-btn-container {
+    text-align: center;
+    margin: 1rem 0;
+}
+
+.paypal-btn-container a {
+    display: inline-block;
+    background: linear-gradient(135deg, #003087, #009cde, #012169);
+    color: #fff !important;
+    font-family: 'Exo 2', sans-serif;
+    font-weight: 700;
+    font-size: 0.85rem;
+    padding: 10px 20px;
+    border-radius: 25px;
+    text-decoration: none !important;
+    letter-spacing: 0.5px;
+    box-shadow: 0 4px 15px rgba(0,156,222,0.4);
+    transition: all 0.3s ease;
+}
+
+.paypal-btn-container a:hover {
+    transform: translateY(-2px);
+    box-shadow: 0 8px 25px rgba(0,156,222,0.6);
+}
+
+/* ── Botón de WhatsApp ────────────────────────────────────────────────────── */
+.whatsapp-btn {
+    text-align: center;
+    margin: 0.5rem 0;
+}
+
+.whatsapp-btn a {
+    display: inline-block;
+    background: linear-gradient(135deg, #25d366, #128c7e);
+    color: #fff !important;
+    font-family: 'Exo 2', sans-serif;
+    font-weight: 700;
+    font-size: 0.82rem;
+    padding: 9px 18px;
+    border-radius: 25px;
+    text-decoration: none !important;
+    box-shadow: 0 4px 15px rgba(37,211,102,0.3);
+    transition: all 0.3s ease;
+}
+
+.whatsapp-btn a:hover {
+    transform: translateY(-2px);
+    box-shadow: 0 8px 25px rgba(37,211,102,0.5);
+}
+
+/* ── Sección de donaciones en sidebar ────────────────────────────────────── */
+.donation-section {
+    background: linear-gradient(135deg, rgba(0,229,255,0.06), rgba(233,30,140,0.06));
+    border: 1px solid rgba(0,229,255,0.15);
+    border-radius: var(--radius-md);
+    padding: 1rem;
+    margin: 0.8rem 0;
+}
+
+/* ── Logo sidebar ─────────────────────────────────────────────────────────── */
+.sidebar-logo-container {
+    text-align: center;
+    padding: 0.5rem 0 1rem 0;
+}
+
+/* ── Footer ───────────────────────────────────────────────────────────────── */
+.footer-text {
+    font-family: 'Space Mono', monospace;
+    font-size: 0.65rem;
+    color: var(--gray);
+    text-align: center;
+    letter-spacing: 1px;
+    margin-top: 2rem;
+    opacity: 0.6;
+}
+
+/* ── Scrollbar personalizado ──────────────────────────────────────────────── */
+::-webkit-scrollbar { width: 6px; }
+::-webkit-scrollbar-track { background: var(--bg-primary); }
+::-webkit-scrollbar-thumb {
+    background: linear-gradient(var(--cyan), var(--magenta));
+    border-radius: 3px;
+}
+
+/* ── Animación de pulso para badges ───────────────────────────────────────── */
+@keyframes pulse-glow {
+    0%   { box-shadow: 0 0 5px rgba(0,229,255,0.3); }
+    50%  { box-shadow: 0 0 20px rgba(0,229,255,0.6); }
+    100% { box-shadow: 0 0 5px rgba(0,229,255,0.3); }
+}
+
+.pulse { animation: pulse-glow 2s infinite; }
+
+/* ── Métricas ─────────────────────────────────────────────────────────────── */
+[data-testid="stMetric"] {
+    background: var(--bg-card) !important;
+    border: 1px solid rgba(0,229,255,0.1) !important;
+    border-radius: var(--radius-md) !important;
+    padding: 0.8rem !important;
+}
+</style>
+"""
+
+# Inyectar el CSS al inicio de la app
+st.markdown(CUSTOM_CSS, unsafe_allow_html=True)
+
+
+# =============================================================================
+# SECCIÓN 2: CONSTANTES Y CONFIGURACIÓN GLOBAL
+# =============================================================================
+
+# Directorio donde Argos guardará los modelos descargados (persiste en runtime)
+MODELS_DIR = Path(os.environ.get("ARGOS_PACKAGES_DIR", "/tmp/argos_models"))
+MODELS_DIR.mkdir(parents=True, exist_ok=True)
+
+# Tiempo de vida de los archivos generados (en segundos) — 5 minutos
+FILE_TTL_SECONDS = 300
+
+# Tamaño máximo de archivo permitido (50 MB)
+MAX_FILE_SIZE_MB = 80
+MAX_FILE_SIZE_BYTES = MAX_FILE_SIZE_MB * 1024 * 1024
+
+# Diccionario de idiomas soportados: código ISO → nombre para mostrar
+SUPPORTED_LANGUAGES = {
+    "en": "🇺🇸 Inglés",
+    "es": "🇪🇸 Español",
+    "fr": "🇫🇷 Francés",
+    "de": "🇩🇪 Alemán",
+    "it": "🇮🇹 Italiano",
+    "pt": "🇵🇹 Portugués",
+    "nl": "🇳🇱 Neerlandés",
+    "pl": "🇵🇱 Polaco",
+    "ru": "🇷🇺 Ruso",
+    "ar": "🇸🇦 Árabe",
+    "zh": "🇨🇳 Chino (Simplificado)",
+    "ja": "🇯🇵 Japonés",
+    "ko": "🇰🇷 Coreano",
+    "tr": "🇹🇷 Turco",
+    "sv": "🇸🇪 Sueco",
+    "da": "🇩🇰 Danés",
+    "fi": "🇫🇮 Finlandés",
+    "nb": "🇳🇴 Noruego",
+    "cs": "🇨🇿 Checo",
+    "hu": "🇭🇺 Húngaro",
+}
+
+# Mapa inverso: nombre de display → código
+LANG_NAME_TO_CODE = {v: k for k, v in SUPPORTED_LANGUAGES.items()}
+
+
+# =============================================================================
+# SECCIÓN 3: SISTEMA DE LIMPIEZA AUTOMÁTICA (AUTO-CLEANUP)
+# Cada archivo generado se elimina automáticamente 5 minutos después
+# usando threading.Timer para no bloquear la interfaz.
+# =============================================================================
+
+def schedule_file_deletion(filepath: str, delay: int = FILE_TTL_SECONDS) -> None:
+    """
+    Programa la eliminación automática de un archivo tras 'delay' segundos.
+    
+    Args:
+        filepath: Ruta absoluta del archivo a eliminar.
+        delay:    Segundos hasta la eliminación (por defecto 300 = 5 minutos).
+    """
+    def _delete():
+        try:
+            if os.path.exists(filepath):
+                os.remove(filepath)
+                logger.info(f"🗑️  Archivo eliminado automáticamente: {filepath}")
+        except Exception as e:
+            logger.warning(f"⚠️  No se pudo eliminar {filepath}: {e}")
+
+    # Crear un timer en hilo demonio para no bloquear el proceso principal
+    timer = threading.Timer(delay, _delete)
+    timer.daemon = True  # El timer muere si el proceso principal termina
+    timer.start()
+    logger.info(f"⏱️  Eliminación programada en {delay}s para: {filepath}")
+
+
+# =============================================================================
+# SECCIÓN 4: MOTOR DE TRADUCCIÓN — ARGOS TRANSLATE
+# Implementa "Lazy Loading": los paquetes solo se descargan cuando el usuario
+# selecciona un par de idiomas y ese modelo no está en caché local.
+# =============================================================================
+
+def _configure_argos_paths() -> None:
+    """
+    Configura Argos Translate para usar el directorio de modelos definido en
+    MODELS_DIR, garantizando persistencia entre reinicios del espacio.
+    """
+    try:
+        from argostranslate import package as argos_pkg
+        argos_pkg.update_package_index()
+    except Exception:
+        pass  # Si no hay internet, usa los modelos ya descargados
+
+
+@st.cache_resource(show_spinner=False)
+def get_installed_packages():
+    """
+    Retorna el conjunto de paquetes Argos ya instalados en el sistema.
+    Se cachea en memoria para evitar consultas repetitivas al filesystem.
+    """
+    try:
+        from argostranslate import package as argos_pkg
+        os.environ["ARGOS_PACKAGES_DIR"] = str(MODELS_DIR)
+        installed = argos_pkg.get_installed_packages()
+        return {(p.from_code, p.to_code): p for p in installed}
+    except ImportError:
+        logger.error("Argos Translate no está instalado correctamente.")
+        return {}
+    except Exception as e:
+        logger.error(f"Error al obtener paquetes instalados: {e}")
+        return {}
+
+
+def ensure_language_pair(from_code: str, to_code: str, status_placeholder) -> bool:
+    """
+    Verifica si el par de idiomas (from_code → to_code) está instalado.
+    Si no lo está, lo descarga (Lazy Loading) y muestra progreso al usuario.
+    
+    Args:
+        from_code:          Código ISO del idioma origen (ej: "es").
+        to_code:            Código ISO del idioma destino (ej: "en").
+        status_placeholder: Elemento st.empty() para mostrar mensajes de estado.
+    
+    Returns:
+        True si el par está disponible, False si ocurrió un error.
+    """
+    try:
+        from argostranslate import package as argos_pkg, translate as argos_translate
+
+        # Establecer directorio de modelos
+        os.environ["ARGOS_PACKAGES_DIR"] = str(MODELS_DIR)
+
+        # Verificar si ya está instalado
+        installed_pkgs = {
+            (p.from_code, p.to_code)
+            for p in argos_pkg.get_installed_packages()
+        }
+
+        if (from_code, to_code) in installed_pkgs:
+            logger.info(f"✅ Par ya instalado: {from_code} → {to_code}")
+            return True
+
+        # ── Intentar descarga ───────────────────────────────────────────────
+        status_placeholder.markdown(
+            f'<div class="status-badge processing pulse">⬇️ &nbsp;Descargando modelo {from_code}→{to_code}... (solo la primera vez)</div>',
+            unsafe_allow_html=True
+        )
+
+        # Actualizar índice de paquetes disponibles
+        argos_pkg.update_package_index()
+        available = argos_pkg.get_available_packages()
+
+        # Buscar el paquete específico
+        target_pkg = next(
+            (p for p in available if p.from_code == from_code and p.to_code == to_code),
+            None
+        )
+
+        if target_pkg is None:
+            # Intentar ruta inversa si el par directo no existe
+            status_placeholder.warning(
+                f"⚠️ Par directo {from_code}→{to_code} no disponible. "
+                "Se usará traducción vía inglés como pivote."
+            )
+            return False
+
+        # Descargar e instalar el paquete
+        download_path = target_pkg.download()
+        argos_pkg.install_from_path(download_path)
+
+        # Limpiar caché de st.cache_resource para reflejar el nuevo paquete
+        get_installed_packages.clear()
+
+        status_placeholder.markdown(
+            '<div class="status-badge success">✅ Modelo instalado correctamente</div>',
+            unsafe_allow_html=True
+        )
+        return True
+
+    except Exception as e:
+        logger.error(f"Error al asegurar par de idiomas {from_code}→{to_code}: {e}")
+        status_placeholder.markdown(
+            f'<div class="status-badge error">❌ Error descargando modelo: {str(e)[:80]}</div>',
+            unsafe_allow_html=True
+        )
+        return False
+
+
+def translate_text(text: str, from_code: str, to_code: str) -> str:
+    """
+    Traduce un fragmento de texto usando Argos Translate.
+    Si el par directo no existe, intenta traducir vía inglés (pivote).
+    
+    Args:
+        text:      Texto a traducir.
+        from_code: Código del idioma origen.
+        to_code:   Código del idioma destino.
+    
+    Returns:
+        Texto traducido, o el texto original si ocurre un error.
+    """
+    if not text or not text.strip():
+        return text  # Evitar llamadas innecesarias con texto vacío
+
+    try:
+        from argostranslate import translate as argos_translate
+
+        # Obtener idiomas instalados
+        installed_langs = argos_translate.get_installed_languages()
+        lang_map = {lang.code: lang for lang in installed_langs}
+
+        if from_code not in lang_map or to_code not in lang_map:
+            logger.warning(f"Idioma no disponible: {from_code} o {to_code}")
+            return text  # Devolver original si no hay modelo
+
+        from_lang = lang_map[from_code]
+        to_lang   = lang_map[to_code]
+
+        # Obtener el objeto de traducción directa
+        translation = from_lang.get_translation(to_lang)
+
+        if translation is None:
+            # ── Traducción con pivote inglés ────────────────────────────────
+            logger.info(f"Usando pivote en: {from_code}→en→{to_code}")
+            if "en" in lang_map:
+                en_lang = lang_map["en"]
+                step1 = from_lang.get_translation(en_lang)
+                step2 = en_lang.get_translation(to_lang)
+                if step1 and step2:
+                    intermediate = step1.translate(text)
+                    return step2.translate(intermediate)
+            return text  # Sin ruta posible, devolver original
+
+        return translation.translate(text)
+
+    except Exception as e:
+        logger.error(f"Error en traducción '{text[:30]}...': {e}")
+        return text  # En caso de error, devolver texto original
+
+
+# =============================================================================
+# SECCIÓN 5: PROCESAMIENTO DE PDF
+# Preserva el diseño usando PyMuPDF (fitz):
+#   1. Extrae bloques de texto con sus coordenadas exactas
+#   2. "Tapa" el texto original dibujando un rectángulo del color del fondo
+#   3. Escribe la traducción encima en la misma posición
+# =============================================================================
+
+def _get_background_color(page) -> tuple:
+    """
+    Intenta detectar el color de fondo de una página PDF.
+    Por defecto retorna blanco (1, 1, 1) si no se puede determinar.
+    """
+    try:
+        # Analizar el área de la página buscando el color dominante
+        mat = page.get_pixmap(matrix=__import__("fitz").Matrix(0.1, 0.1))
+        # Obtener el color del píxel en la esquina superior izquierda
+        pixel = mat.pixel(0, 0)
+        # Normalizar valores RGB a rango 0-1 que usa PyMuPDF
+        return (pixel[0]/255.0, pixel[1]/255.0, pixel[2]/255.0)
+    except Exception:
+        return (1.0, 1.0, 1.0)  # Blanco por defecto
+
+
+def translate_pdf(
+    input_path: str,
+    from_code: str,
+    to_code: str,
+    progress_bar,
+    status_text
+) -> str:
+    """
+    Traduce un archivo PDF página por página, preservando el layout original.
+    
+    Proceso por página:
+      1. Obtener bloques de texto con coordenadas (x0, y0, x1, y1)
+      2. Detectar el color de fondo local del área del texto
+      3. Cubrir el texto original con un rectángulo opaco
+      4. Insertar la traducción en la misma posición con el mismo tamaño de fuente
+    
+    Args:
+        input_path:   Ruta al PDF original.
+        from_code:    Código de idioma origen.
+        to_code:      Código de idioma destino.
+        progress_bar: Componente st.progress() para mostrar avance.
+        status_text:  Componente st.empty() para mensajes de estado.
+    
+    Returns:
+        Ruta al PDF traducido (guardado en /tmp).
+    
+    Raises:
+        ValueError: Si el archivo no es un PDF válido.
+        MemoryError: Si el PDF es demasiado grande para procesarlo.
+    """
+    try:
+        import fitz  # PyMuPDF
+
+        # Abrir el documento PDF
+        doc = fitz.open(input_path)
+        total_pages = len(doc)
+
+        if total_pages == 0:
+            raise ValueError("El PDF no contiene páginas.")
+
+        # Informar al usuario
+        status_text.markdown(
+            f'<div class="status-badge processing">📄 Procesando {total_pages} página(s)...</div>',
+            unsafe_allow_html=True
+        )
+
+        for page_num in range(total_pages):
+            page = doc[page_num]
+
+            # Obtener color de fondo de esta página
+            bg_color = _get_background_color(page)
+
+            # Determinar si el fondo es oscuro (para usar texto blanco)
+            is_dark_bg = (bg_color[0] + bg_color[1] + bg_color[2]) / 3 < 0.5
+            text_color = (1.0, 1.0, 1.0) if is_dark_bg else (0.0, 0.0, 0.0)
+
+            # Extraer bloques de texto con posición y tamaño de fuente
+            # get_text("dict") retorna estructura JSON con bloques detallados
+            page_data = page.get_text("dict", flags=fitz.TEXT_PRESERVE_WHITESPACE)
+
+            for block in page_data.get("blocks", []):
+                # Solo procesar bloques de texto (type=0), omitir imágenes (type=1)
+                if block.get("type") != 0:
+                    continue
+
+                for line in block.get("lines", []):
+                    for span in line.get("spans", []):
+                        original_text = span.get("text", "").strip()
+
+                        # Omitir spans vacíos o muy cortos (espacios, signos)
+                        if len(original_text) < 2:
+                            continue
+
+                        # Coordenadas del span (rectángulo del texto)
+                        bbox = fitz.Rect(span["bbox"])
+                        font_size = span.get("size", 11)
+
+                        # Traducir el fragmento de texto
+                        translated = translate_text(original_text, from_code, to_code)
+
+                        # ── PASO 1: Cubrir el texto original ────────────────
+                        # Dibujar rectángulo opaco del color del fondo
+                        # Expandir ligeramente el rect para cubrir bien
+                        cover_rect = bbox + (-1, -1, 1, 1)
+                        page.draw_rect(cover_rect, color=None, fill=bg_color)
+
+                        # ── PASO 2: Escribir la traducción encima ────────────
+                        try:
+                            # Insertar el texto traducido en la misma posición
+                            rc = page.insert_textbox(
+                                bbox,
+                                translated,
+                                fontsize=font_size * 0.92,  # Reducir 8% para que quepa
+                                color=text_color,
+                                align=0,        # 0=izquierda, 1=centro, 2=derecha
+                                overlay=True    # Colocar encima de todo
+                            )
+                            # rc < 0 indica que el texto no cupo en el box
+                            if rc < 0:
+                                # Reducir fuente hasta que quepa
+                                page.insert_textbox(
+                                    bbox,
+                                    translated,
+                                    fontsize=max(6, font_size * 0.7),
+                                    color=text_color,
+                                    align=0,
+                                    overlay=True
+                                )
+                        except Exception as te:
+                            logger.warning(f"Error insertando texto en pág {page_num+1}: {te}")
+
+            # Actualizar barra de progreso
+            progress = (page_num + 1) / total_pages
+            progress_bar.progress(progress, text=f"Página {page_num + 1} / {total_pages}")
+
+        # ── Guardar el PDF traducido en /tmp ───────────────────────────────
+        timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+        output_filename = f"traducido_{from_code}_to_{to_code}_{timestamp}.pdf"
+        output_path = os.path.join(tempfile.gettempdir(), output_filename)
+
+        doc.save(output_path, garbage=4, deflate=True)
+        doc.close()
+
+        # Programar eliminación automática
+        schedule_file_deletion(output_path)
+
+        logger.info(f"✅ PDF traducido guardado: {output_path}")
+        return output_path
+
+    except MemoryError:
+        raise MemoryError(
+            f"El PDF es demasiado pesado para procesarlo en memoria. "
+            f"Por favor, divídelo en partes de máximo {MAX_FILE_SIZE_MB}MB."
+        )
+    except Exception as e:
+        logger.error(f"Error al traducir PDF: {e}")
+        raise
+
+
+# =============================================================================
+# SECCIÓN 6: PROCESAMIENTO DE WORD (DOCX)
+# Usa python-docx para preservar:
+#   - Negritas, cursivas, subrayado
+#   - Alineación de párrafos
+#   - Contenido de tablas (celda por celda)
+# =============================================================================
+
+def translate_docx(
+    input_path: str,
+    from_code: str,
+    to_code: str,
+    progress_bar,
+    status_text
+) -> str:
+    """
+    Traduce un archivo Word (.docx) respetando el formato original.
+    
+    Proceso:
+      - Párrafos: traducir cada run preservando bold/italic/underline/color
+      - Tablas: iterar filas → celdas → párrafos → runs
+      - Headers y Footers: traducir si contienen texto relevante
+    
+    Args:
+        input_path:   Ruta al .docx original.
+        from_code:    Código de idioma origen.
+        to_code:      Código de idioma destino.
+        progress_bar: Componente st.progress().
+        status_text:  Componente st.empty().
+    
+    Returns:
+        Ruta al .docx traducido.
+    """
+    try:
+        from docx import Document
+        from docx.oxml.ns import qn
+        import copy
+
+        # Abrir el documento
+        doc = Document(input_path)
+
+        # Contar total de elementos para la barra de progreso
+        total_paragraphs = len(doc.paragraphs)
+        total_tables = sum(
+            len(table.rows) * len(table.columns)
+            for table in doc.tables
+        )
+        total_elements = max(total_paragraphs + total_tables, 1)
+        processed = 0
+
+        status_text.markdown(
+            f'<div class="status-badge processing">📝 Procesando {total_paragraphs} párrafo(s) + {len(doc.tables)} tabla(s)...</div>',
+            unsafe_allow_html=True
+        )
+
+        # ── Función auxiliar para traducir runs de un párrafo ─────────────
+        def translate_paragraph_runs(paragraph):
+            """
+            Traduce el contenido de un párrafo preservando el formato de cada run.
+            
+            Estrategia: agrupa todos los runs en un solo texto para contexto,
+            traduce, y redistribuye el resultado respetando los runs originales.
+            """
+            # Recopilar texto completo del párrafo
+            full_text = "".join(run.text for run in paragraph.runs)
+
+            if not full_text.strip():
+                return  # Párrafo vacío, nada que hacer
+
+            # Traducir el texto completo del párrafo
+            translated_text = translate_text(full_text, from_code, to_code)
+
+            if not paragraph.runs:
+                return
+
+            # Estrategia: poner toda la traducción en el primer run
+            # y vaciar los demás (preserva el formato del primer run)
+            paragraph.runs[0].text = translated_text
+            for run in paragraph.runs[1:]:
+                run.text = ""
+
+        # ── Procesar párrafos del cuerpo principal ─────────────────────────
+        for para in doc.paragraphs:
+            try:
+                translate_paragraph_runs(para)
+            except Exception as pe:
+                logger.warning(f"Error en párrafo: {pe}")
+            finally:
+                processed += 1
+                progress_bar.progress(
+                    min(processed / total_elements, 1.0),
+                    text=f"Párrafo {processed} / {total_paragraphs}"
+                )
+
+        # ── Procesar tablas ────────────────────────────────────────────────
+        for table_idx, table in enumerate(doc.tables):
+            for row_idx, row in enumerate(table.rows):
+                for cell_idx, cell in enumerate(row.cells):
+                    for para in cell.paragraphs:
+                        try:
+                            translate_paragraph_runs(para)
+                        except Exception as ce:
+                            logger.warning(
+                                f"Error en tabla {table_idx}, "
+                                f"fila {row_idx}, celda {cell_idx}: {ce}"
+                            )
+                    processed += 1
+                    progress_bar.progress(
+                        min(processed / total_elements, 1.0),
+                        text=f"Tabla {table_idx+1}, celda {row_idx+1},{cell_idx+1}"
+                    )
+
+        # ── Procesar encabezados y pies de página ─────────────────────────
+        for section in doc.sections:
+            # Encabezado (header)
+            if section.header:
+                for para in section.header.paragraphs:
+                    try:
+                        translate_paragraph_runs(para)
+                    except Exception:
+                        pass
+            # Pie de página (footer)
+            if section.footer:
+                for para in section.footer.paragraphs:
+                    try:
+                        translate_paragraph_runs(para)
+                    except Exception:
+                        pass
+
+        # ── Guardar el documento traducido ─────────────────────────────────
+        timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+        output_filename = f"traducido_{from_code}_to_{to_code}_{timestamp}.docx"
+        output_path = os.path.join(tempfile.gettempdir(), output_filename)
+
+        doc.save(output_path)
+
+        # Programar eliminación automática
+        schedule_file_deletion(output_path)
+
+        logger.info(f"✅ DOCX traducido guardado: {output_path}")
+        return output_path
+
+    except MemoryError:
+        raise MemoryError(
+            "El documento Word es demasiado pesado. "
+            "Por favor, divídelo en documentos más pequeños."
+        )
+    except Exception as e:
+        logger.error(f"Error al traducir DOCX: {e}")
+        raise
+
+
+# =============================================================================
+# SECCIÓN 7: VALIDACIÓN DE ARCHIVOS
+# Verifica formato, extensión y tamaño antes de procesar.
+# =============================================================================
+
+def validate_uploaded_file(uploaded_file) -> tuple[bool, str]:
+    """
+    Valida que el archivo subido sea válido para procesamiento.
+    
+    Verificaciones:
+      1. Extensión permitida (.pdf o .docx)
+      2. Tamaño máximo (MAX_FILE_SIZE_BYTES)
+      3. Que el archivo no esté vacío
+    
+    Args:
+        uploaded_file: Objeto retornado por st.file_uploader().
+    
+    Returns:
+        Tupla (es_válido: bool, mensaje_error: str).
+        Si es_válido=True, mensaje_error estará vacío.
+    """
+    if uploaded_file is None:
+        return False, "No se ha subido ningún archivo."
+
+    # Verificar extensión
+    filename = uploaded_file.name.lower()
+    if not (filename.endswith(".pdf") or filename.endswith(".docx")):
+        return False, (
+            "❌ Formato no permitido. Solo se aceptan archivos `.pdf` y `.docx`.\n"
+            "Si tienes un `.doc` antiguo, conviértelo primero a `.docx` con Word o LibreOffice."
+        )
+
+    # Verificar tamaño
+    file_size = uploaded_file.size
+    if file_size > MAX_FILE_SIZE_BYTES:
+        size_mb = file_size / (1024 * 1024)
+        return False, (
+            f"❌ El archivo pesa {size_mb:.1f} MB, excede el límite de {MAX_FILE_SIZE_MB} MB.\n"
+            "Por favor, divide el archivo en partes más pequeñas."
+        )
+
+    # Verificar que no esté vacío
+    if file_size == 0:
+        return False, "❌ El archivo está vacío."
+
+    return True, ""
+
+
+# =============================================================================
+# SECCIÓN 8: INTERFAZ DE USUARIO — SIDEBAR
+# Contiene: logo, selectores de idioma, donaciones, soporte.
+# =============================================================================
+
+def render_sidebar() -> tuple[str, str]:
+    """
+    Renderiza la barra lateral completa con todos sus componentes.
+    
+    Returns:
+        Tupla (código_idioma_origen, código_idioma_destino).
+    """
+    with st.sidebar:
+        # ── Logo de la empresa ─────────────────────────────────────────────
+        st.markdown('<div class="sidebar-logo-container">', unsafe_allow_html=True)
+        try:
+            # Intentar mostrar el logo si está disponible
+            logo_path = Path("LOGO_ADVISION_AI_TRANSPARENTE.png")
+            if logo_path.exists():
+                st.image(str(logo_path), use_container_width=True)
+            else:
+                # Fallback: texto estilizado si no hay imagen
+                st.markdown(
+                    '<div style="font-family:\'Exo 2\',sans-serif;font-weight:900;'
+                    'font-size:1.4rem;background:linear-gradient(135deg,#00e5ff,#e91e8c);'
+                    '-webkit-background-clip:text;-webkit-text-fill-color:transparent;'
+                    'background-clip:text;text-align:center;">AdVision AI</div>',
+                    unsafe_allow_html=True
+                )
+        except Exception:
+            pass
+        st.markdown('</div>', unsafe_allow_html=True)
+
+        # ── Divisor visual ─────────────────────────────────────────────────
+        st.markdown('<hr class="gradient-divider">', unsafe_allow_html=True)
+
+        # ── Selector de idioma origen ──────────────────────────────────────
+        st.markdown('<p class="section-label">🔤 Idioma Origen</p>', unsafe_allow_html=True)
+        lang_names = list(SUPPORTED_LANGUAGES.values())
+
+        # Índice por defecto: Español (índice 1)
+        default_from_idx = lang_names.index("🇪🇸 Español") if "🇪🇸 Español" in lang_names else 0
+        from_lang_name = st.selectbox(
+            "Origen",
+            options=lang_names,
+            index=default_from_idx,
+            label_visibility="collapsed",
+            key="select_from_lang"
+        )
+
+        # ── Flecha indicadora de dirección ─────────────────────────────────
+        st.markdown(
+            '<div style="text-align:center;font-size:1.3rem;margin:4px 0;'
+            'background:linear-gradient(135deg,#00e5ff,#e91e8c);'
+            '-webkit-background-clip:text;-webkit-text-fill-color:transparent;">⬇️</div>',
+            unsafe_allow_html=True
+        )
+
+        # ── Selector de idioma destino ─────────────────────────────────────
+        st.markdown('<p class="section-label">🎯 Idioma Destino</p>', unsafe_allow_html=True)
+
+        # Índice por defecto: Inglés (índice 0)
+        default_to_idx = lang_names.index("🇺🇸 Inglés") if "🇺🇸 Inglés" in lang_names else 1
+        to_lang_name = st.selectbox(
+            "Destino",
+            options=lang_names,
+            index=default_to_idx,
+            label_visibility="collapsed",
+            key="select_to_lang"
+        )
+
+        # Aviso si el usuario seleccionó el mismo idioma en origen y destino
+        from_code = LANG_NAME_TO_CODE[from_lang_name]
+        to_code   = LANG_NAME_TO_CODE[to_lang_name]
+
+        if from_code == to_code:
+            st.warning("⚠️ Selecciona idiomas diferentes para origen y destino.")
+
+        # ── Divisor ────────────────────────────────────────────────────────
+        st.markdown('<hr class="gradient-divider">', unsafe_allow_html=True)
+
+        # ── Sección de Soporte y Donaciones ───────────────────────────────
+        st.markdown(
+            '<div class="donation-section">'
+            '<p class="section-label" style="text-align:center;">💎 Soporte & Donaciones</p>'
+            '<p style="font-size:0.78rem;color:#aaa;text-align:center;margin-bottom:0.8rem;">'
+            'Si esta herramienta te resulta útil, considera apoyar su desarrollo:</p>',
+            unsafe_allow_html=True
+        )
+
+        # Botón de PayPal — REEMPLAZA TU_USUARIO_AQUI con tu usuario real
+        st.markdown(
+            '<div class="paypal-btn-container">'
+            '<a href="https://www.paypal.me/Noru3D" target="_blank" rel="noopener">'
+            '💙 Donar con PayPal'
+            '</a>'
+            '</div>',
+            unsafe_allow_html=True
+        )
+
+        st.markdown('</div>', unsafe_allow_html=True)
+
+        # ── Botón de contacto WhatsApp ─────────────────────────────────────
+        st.markdown(
+            '<div class="whatsapp-btn" style="margin-top:0.6rem;">'
+            # REEMPLAZA el número con tu número real de WhatsApp (con código de país)
+            '<a href="https://wa.me/5215537494034?text=Hola%2C%20necesito%20soporte%20con%20LibreTranslate%20ProDoc" '
+            'target="_blank" rel="noopener">'
+            '💬 Soporte por WhatsApp'
+            '</a>'
+            '</div>',
+            unsafe_allow_html=True
+        )
+
+        # ── Información adicional ──────────────────────────────────────────
+        st.markdown('<hr class="gradient-divider">', unsafe_allow_html=True)
+        st.markdown(
+            '<p style="font-size:0.68rem;color:#555;text-align:center;line-height:1.5;">'
+            '🔒 Sin telemetría · 🌐 Offline · 🗑️ Auto-limpieza 5 min<br>'
+            '<span style="color:#333;">Motor: Argos Translate</span>'
+            '</p>',
+            unsafe_allow_html=True
+        )
+
+    return from_code, to_code
+
+
+# =============================================================================
+# SECCIÓN 9: INTERFAZ DE USUARIO — ÁREA PRINCIPAL
+# =============================================================================
+
+def render_main_area(from_code: str, to_code: str) -> None:
+    """
+    Renderiza el área principal de la aplicación:
+      - Encabezado con título y descripción
+      - Zona de carga de archivo
+      - Panel de información
+      - Proceso de traducción y descarga
+    
+    Args:
+        from_code: Código del idioma origen seleccionado en el sidebar.
+        to_code:   Código del idioma destino seleccionado en el sidebar.
+    """
+
+    # ── Encabezado principal ───────────────────────────────────────────────
+    st.markdown('<h1 class="app-title">LibreTranslate ProDoc</h1>', unsafe_allow_html=True)
+    st.markdown(
+        '<p class="app-subtitle">Traducción offline · Preserva el diseño · Sin límites</p>',
+        unsafe_allow_html=True
+    )
+
+    # ── Descripción / intro ────────────────────────────────────────────────
+    col_info1, col_info2, col_info3 = st.columns(3)
+
+    with col_info1:
+        st.markdown(
+            '<div class="pro-card" style="text-align:center;">'
+            '<div style="font-size:2rem;">📄</div>'
+            '<div style="font-weight:700;margin:6px 0;font-size:0.9rem;">PDF & Word</div>'
+            '<div style="font-size:0.75rem;color:#888;">Soporte completo para .pdf y .docx con preservación de diseño</div>'
+            '</div>',
+            unsafe_allow_html=True
+        )
+
+    with col_info2:
+        st.markdown(
+            '<div class="pro-card" style="text-align:center;">'
+            '<div style="font-size:2rem;">🔒</div>'
+            '<div style="font-weight:700;margin:6px 0;font-size:0.9rem;">100% Offline</div>'
+            '<div style="font-size:0.75rem;color:#888;">Motor Argos Translate local. Tus documentos no salen del servidor</div>'
+            '</div>',
+            unsafe_allow_html=True
+        )
+
+    with col_info3:
+        st.markdown(
+            '<div class="pro-card" style="text-align:center;">'
+            '<div style="font-size:2rem;">🗑️</div>'
+            '<div style="font-weight:700;margin:6px 0;font-size:0.9rem;">Auto-limpieza</div>'
+            '<div style="font-size:0.75rem;color:#888;">Los archivos se eliminan automáticamente del servidor en 5 minutos</div>'
+            '</div>',
+            unsafe_allow_html=True
+        )
+
+    st.markdown("<br>", unsafe_allow_html=True)
+
+    # ── Mostrar idiomas seleccionados ──────────────────────────────────────
+    from_name = SUPPORTED_LANGUAGES.get(from_code, from_code)
+    to_name   = SUPPORTED_LANGUAGES.get(to_code, to_code)
+
+    st.markdown(
+        f'<div class="pro-card">'
+        f'<p class="section-label">Par de traducción activo</p>'
+        f'<div style="display:flex;align-items:center;gap:12px;flex-wrap:wrap;">'
+        f'<span class="status-badge ready">{from_name}</span>'
+        f'<span style="font-size:1.2rem;opacity:0.6;">→</span>'
+        f'<span class="status-badge ready">{to_name}</span>'
+        f'</div>'
+        f'</div>',
+        unsafe_allow_html=True
+    )
+
+    # ── Zona de carga de archivo ───────────────────────────────────────────
+    st.markdown(
+        '<div class="pro-card">'
+        '<p class="section-label">📤 Cargar Documento</p>',
+        unsafe_allow_html=True
+    )
+
+    uploaded_file = st.file_uploader(
+        label="Arrastra tu archivo aquí o haz clic para seleccionarlo",
+        type=["pdf", "docx"],
+        help=f"Formatos permitidos: PDF y DOCX · Tamaño máximo: {MAX_FILE_SIZE_MB} MB",
+        accept_multiple_files=False
+    )
+
+    st.markdown('</div>', unsafe_allow_html=True)
+
+    # ── Validación y proceso de traducción ────────────────────────────────
+    if uploaded_file is not None:
+        # Validar el archivo antes de continuar
+        is_valid, error_msg = validate_uploaded_file(uploaded_file)
+
+        if not is_valid:
+            st.error(error_msg)
+            return
+
+        # Mostrar información del archivo
+        file_size_mb = uploaded_file.size / (1024 * 1024)
+        file_ext = Path(uploaded_file.name).suffix.lower()
+
+        st.markdown(
+            f'<div class="pro-card">'
+            f'<p class="section-label">📁 Archivo Cargado</p>'
+            f'<div style="display:flex;gap:12px;align-items:center;flex-wrap:wrap;">'
+            f'<span class="status-badge ready">{"📄 PDF" if file_ext == ".pdf" else "📝 DOCX"}</span>'
+            f'<span style="font-size:0.85rem;color:#ccc;">{uploaded_file.name}</span>'
+            f'<span style="font-size:0.8rem;color:#888;">{file_size_mb:.2f} MB</span>'
+            f'</div>'
+            f'</div>',
+            unsafe_allow_html=True
+        )
+
+        # Verificar que los idiomas sean diferentes
+        if from_code == to_code:
+            st.warning("⚠️ Selecciona idiomas diferentes en la barra lateral para continuar.")
+            return
+
+        # ── Botón principal de traducción ──────────────────────────────────
+        col_btn, col_space = st.columns([1, 3])
+        with col_btn:
+            translate_btn = st.button(
+                "🌐 Traducir Documento",
+                use_container_width=True,
+                type="primary"
+            )
+
+        if translate_btn:
+            _process_translation(
+                uploaded_file=uploaded_file,
+                from_code=from_code,
+                to_code=to_code,
+                file_ext=file_ext
+            )
+
+
+def _process_translation(
+    uploaded_file,
+    from_code: str,
+    to_code: str,
+    file_ext: str
+) -> None:
+    """
+    Orquesta el proceso completo de traducción:
+      1. Descarga el modelo de idioma si es necesario (Lazy Loading)
+      2. Guarda el archivo subido en /tmp
+      3. Llama al traductor correspondiente (PDF o DOCX)
+      4. Ofrece el archivo traducido para descarga
+      5. Limpia el archivo de entrada
+    
+    Args:
+        uploaded_file: Archivo subido por el usuario (BytesIO-like object).
+        from_code:     Código del idioma origen.
+        to_code:       Código del idioma destino.
+        file_ext:      Extensión del archivo ('.pdf' o '.docx').
+    """
+
+    # ── Contenedores de estado para retroalimentación visual ───────────────
+    status_placeholder = st.empty()
+    progress_placeholder = st.empty()
+
+    # Barra de progreso inicial
+    progress_bar = progress_placeholder.progress(0, text="Iniciando traducción...")
+
+    try:
+        # ── PASO 1: Verificar/descargar modelo de idioma ───────────────────
+        status_placeholder.markdown(
+            '<div class="status-badge processing pulse">⚙️ &nbsp;Verificando modelos de idioma...</div>',
+            unsafe_allow_html=True
+        )
+
+        model_ok = ensure_language_pair(from_code, to_code, status_placeholder)
+
+        if not model_ok:
+            # Intentar con pivote inglés (en→to_code si from!=en, o from→en si to!=en)
+            st.info(
+                "ℹ️ El par directo no está disponible. "
+                "Se intentará la traducción vía inglés como idioma pivote. "
+                "Esto puede requerir descargar hasta 2 modelos adicionales."
+            )
+            # Descargar from→en
+            if from_code != "en":
+                ensure_language_pair(from_code, "en", status_placeholder)
+            # Descargar en→to
+            if to_code != "en":
+                ensure_language_pair("en", to_code, status_placeholder)
+
+        # ── PASO 2: Guardar archivo subido a /tmp ──────────────────────────
+        timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+        input_filename = f"input_{timestamp}{file_ext}"
+        input_path = os.path.join(tempfile.gettempdir(), input_filename)
+
+        with open(input_path, "wb") as f:
+            f.write(uploaded_file.getbuffer())
+
+        # Programar eliminación del archivo de entrada también
+        schedule_file_deletion(input_path)
+
+        progress_bar.progress(0.05, text="Archivo cargado al servidor (se eliminará en 5 min)...")
+
+        # ── PASO 3: Ejecutar la traducción según el tipo de archivo ────────
+        status_placeholder.markdown(
+            f'<div class="status-badge processing pulse">🔄 &nbsp;Traduciendo {file_ext.upper()[1:]}...</div>',
+            unsafe_allow_html=True
+        )
+
+        start_time = time.time()
+
+        if file_ext == ".pdf":
+            output_path = translate_pdf(
+                input_path=input_path,
+                from_code=from_code,
+                to_code=to_code,
+                progress_bar=progress_bar,
+                status_text=status_placeholder
+            )
+        elif file_ext == ".docx":
+            output_path = translate_docx(
+                input_path=input_path,
+                from_code=from_code,
+                to_code=to_code,
+                progress_bar=progress_bar,
+                status_text=status_placeholder
+            )
+        else:
+            raise ValueError(f"Extensión no soportada: {file_ext}")
+
+        elapsed_time = time.time() - start_time
+        progress_bar.progress(1.0, text="✅ ¡Traducción completada!")
+
+        # ── PASO 4: Mostrar resultado y botón de descarga ──────────────────
+        status_placeholder.markdown(
+            f'<div class="status-badge success">✅ &nbsp;Traducción completada en {elapsed_time:.1f}s</div>',
+            unsafe_allow_html=True
+        )
+
+        # Leer el archivo traducido para la descarga
+        with open(output_path, "rb") as f:
+            translated_bytes = f.read()
+
+        # Nombre sugerido para la descarga
+        original_stem = Path(uploaded_file.name).stem
+        download_name = f"{original_stem}_traducido_{to_code}{file_ext}"
+
+        # ── Card de resultado ──────────────────────────────────────────────
+        st.markdown(
+            '<div class="pro-card">'
+            '<p class="section-label">✨ Documento Traducido</p>',
+            unsafe_allow_html=True
+        )
+
+        col_dl, col_info = st.columns([1, 2])
+
+        with col_dl:
+            # Determinar el MIME type para la descarga
+            mime_type = "application/pdf" if file_ext == ".pdf" else (
+                "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
+            )
+            st.download_button(
+                label=f"⬇️ Descargar {file_ext.upper()[1:]} Traducido",
+                data=translated_bytes,
+                file_name=download_name,
+                mime=mime_type,
+                use_container_width=True
+            )
+
+        with col_info:
+            output_size_mb = len(translated_bytes) / (1024 * 1024)
+            st.markdown(
+                f'<div style="font-size:0.8rem;color:#888;line-height:1.8;">'
+                f'📁 <b style="color:#ccc;">{download_name}</b><br>'
+                f'📦 Tamaño: <b style="color:#ccc;">{output_size_mb:.2f} MB</b><br>'
+                f'⏱️ Tiempo: <b style="color:#ccc;">{elapsed_time:.1f} segundos</b><br>'
+                f'🗑️ Se eliminará del servidor en <b style="color:#00e5ff;">5 minutos</b>'
+                f'</div>',
+                unsafe_allow_html=True
+            )
+
+        st.markdown('</div>', unsafe_allow_html=True)
+
+        # ── Advertencia sobre limitaciones ─────────────────────────────────
+        st.info(
+            "📌 **Nota:** La preservación del diseño depende de la complejidad del documento. "
+            "PDFs con fuentes incrustadas no estándar o con mucho contenido de imagen "
+            "pueden mostrar diferencias visuales. El texto traducido puede ser más largo "
+            "que el original, lo que ocasionalmente afecta el layout."
+        )
+
+    except MemoryError as me:
+        progress_bar.progress(0, text="Error")
+        st.error(str(me))
+        status_placeholder.markdown(
+            '<div class="status-badge error">❌ Error: Archivo demasiado grande</div>',
+            unsafe_allow_html=True
+        )
+
+    except Exception as e:
+        progress_bar.progress(0, text="Error")
+        error_detail = str(e)
+        st.error(
+            f"❌ **Error durante la traducción:**\n\n"
+            f"```\n{error_detail[:300]}\n```\n\n"
+            "Por favor, intenta con un archivo más pequeño o verifica que no esté corrupto."
+        )
+        status_placeholder.markdown(
+            '<div class="status-badge error">❌ Error en el procesamiento</div>',
+            unsafe_allow_html=True
+        )
+        logger.error(f"Error en _process_translation: {e}", exc_info=True)
+
+
+# =============================================================================
+# SECCIÓN 10: PUNTO DE ENTRADA PRINCIPAL
+# =============================================================================
+
+def main():
+    """
+    Función principal que orquesta el renderizado de la aplicación completa.
+    
+    Flujo de ejecución:
+      1. Renderizar sidebar y obtener preferencias de idioma del usuario
+      2. Renderizar el área principal con la lógica de carga y traducción
+      3. Mostrar footer
+    """
+
+    # ── Renderizar sidebar y obtener selección de idiomas ──────────────────
+    from_code, to_code = render_sidebar()
+
+    # ── Renderizar área principal ──────────────────────────────────────────
+    render_main_area(from_code, to_code)
+
+    # ── Footer ─────────────────────────────────────────────────────────────
+    st.markdown(
+        '<div class="footer-text">'
+        'LibreTranslate ProDoc · Powered by Argos Translate & PyMuPDF · '
+        'Desarrollado con ❤️ por AdVision AI · '
+        f'Versión 1.0.0'
+        '</div>',
+        unsafe_allow_html=True
+    )
+
+
+# ── Ejecutar la aplicación ─────────────────────────────────────────────────
+if __name__ == "__main__":
+    main()

packages.txt

@@ -0,0 +1,25 @@
+# =============================================================================
+# packages.txt — LibreTranslate ProDoc
+# Dependencias de sistema Linux (Ubuntu/Debian) para Hugging Face Spaces
+# =============================================================================
+# Estas se instalan con apt-get ANTES que los paquetes Python.
+# Hugging Face Spaces las lee automáticamente en el despliegue.
+# =============================================================================
+
+# ── Requerido por PyMuPDF (fitz) para renderizado de fuentes ──────────────
+libmupdf-dev
+
+# ── Soporte de fuentes del sistema para inserción de texto en PDFs ─────────
+fonts-liberation
+fonts-dejavu-core
+fonts-noto
+fonts-noto-cjk
+
+# ── Requerido por Argos Translate para compilación de modelos CTranslate2 ──
+libgomp1
+
+# ── Herramientas de construcción necesarias para compilar algunas deps ──────
+build-essential
+
+# ── SSL y certificados (necesario para descargar paquetes de Argos) ─────────
+ca-certificates

requirements.txt

@@ -1,3 +1,31 @@
-altair
-pandas
-streamlit
+# =============================================================================
+# requirements.txt — LibreTranslate ProDoc
+# Hugging Face Spaces (SDK: Streamlit)
+# =============================================================================
+# INSTRUCCIONES:
+#   Hugging Face Spaces instala estas dependencias automáticamente al desplegar.
+#   NO modifiques las versiones fijas sin probar compatibilidad primero.
+# =============================================================================
+
+# ── Framework principal de UI ──────────────────────────────────────────────
+streamlit>=1.35.0,<2.0.0
+
+# ── Motor de traducción offline ────────────────────────────────────────────
+# argostranslate: Traducción local sin APIs externas
+argostranslate>=1.9.6
+
+# ── Procesamiento de PDF ───────────────────────────────────────────────────
+# PyMuPDF (importado como 'fitz'): Lectura y escritura de PDFs con soporte
+# para extracción de texto por coordenadas y dibujo sobre páginas
+PyMuPDF>=1.24.0
+
+# ── Procesamiento de Word (.docx) ──────────────────────────────────────────
+# python-docx: Leer y escribir documentos Word preservando formato
+python-docx>=1.1.0
+
+# ── Utilidades estándar (incluidas en Python, no requieren instalación) ─────
+# threading  — ya incluido en stdlib
+# tempfile   — ya incluido en stdlib
+# pathlib    — ya incluido en stdlib
+# logging    — ya incluido en stdlib
+# os, sys    — ya incluidos en stdlib