Metadata-Version: 2.4
Name: leviathan-ui
Version: 1.0.5
Summary: Premium UI framework for PyQt6 with Windows 11 aesthetics, blur effects, i18n support, wheel packaging and modern developer documentation
Author-email: Jesus Quijada <jesusquijada.gh34@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/JesusQuijada34/leviathan-ui
Project-URL: Documentation, https://github.com/JesusQuijada34/leviathan-ui#readme
Project-URL: Repository, https://github.com/JesusQuijada34/leviathan-ui
Project-URL: Issues, https://github.com/JesusQuijada/leviathan-ui/issues
Keywords: pyqt6,ui,windows11,blur,splash,frameless,modern-ui,i18n
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: Microsoft :: Windows
Classifier: Topic :: Software Development :: User Interfaces
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyQt6>=6.5.0
Requires-Dist: Pillow>=9.0.0
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: flake8; extra == "dev"
Requires-Dist: mypy; extra == "dev"
Provides-Extra: build
Requires-Dist: pyinstaller; extra == "build"
Requires-Dist: twine; extra == "build"
Requires-Dist: build; extra == "build"
Dynamic: license-file

# 🌊 Leviathan-UI: Framework Premium para PyQt6 (v1.0.5)

**Leviathan-UI** es un framework profesional para crear aplicaciones de escritorio con el aspecto moderno de **Windows 11** usando Python y PyQt6.

> **Lanzamiento 1.0.5** — Instalador profesional refinado, UI compacta y navegación fluida entre páginas.

[![Python](https://img.shields.io/badge/Python-3.8%2B-blue)](https://python.org)
[![PyQt6](https://img.shields.io/badge/PyQt6-6.5%2B-green)](https://pypi.org/project/PyQt6/)
[![License](https://img.shields.io/badge/License-MIT-yellow)](LICENSE)

## 📚 Documentación

Este repositorio incluye documentación estructurada en `docs/`:

- `docs/overview.md` — visión general del framework.
- `docs/faq.md` — respuestas a preguntas frecuentes.
- `docs/dev-community-post.md` — post listo para publicar en comunidades de desarrolladores.
- `docs/index.md` — índice de documentación.

---
## 🚀 Publicación en PyPI

Para publicar en PyPI necesitas un **token de acceso** de PyPI (no tu contraseña). El flujo correcto es:

1. Crear el token en tu cuenta de PyPI.
2. Guardarlo localmente en `~/.pypirc` o usar `twine upload --non-interactive -u __token__ -p <TOKEN> dist/*`.
3. Asegurar que el paquete es compatible instalando la rueda:

```bash
python -m pip install dist/leviathan_ui-1.0.4-py3-none-any.whl
```

4. Subir con twine:

```bash
python -m pip install --upgrade twine
python -m twine upload dist/*
```

> No incluyas el token en el repositorio. Usa `.pypirc.example` como plantilla.

---

## 🚀 ¿Qué hay de nuevo? (v1.0.5)

### ✨ Novedades
- **🎯 Navegación Wizard**: Interface de instalación tipo NSIS con 4 páginas claras y botones de navegación
- **📊 Indicador Visual**: 4 dots que muestran progreso (● ● ● ●)
- **🖼️ Splash Integrado**: Logo y título en ventana principal con fade-out suave
- **📐 Layout Compacto**: 720×480px optimizado, sin espacio desperdiciado

### � Correcciones
- **Navegación fluida**: Transiciones instantáneas entre páginas del instalador
- **Fondo uniforme**: #121822 oscuro en todos los widgets, sin bordes azules de Windows
- **Banners proporcionales**: Aspect ratio correcto mantenido al redimensionar
- **PyQt6 API moderna**: Uso correcto de `QEasingCurve.Type.OutQuad`

Hemos mejorado el framework para que sea más fácil de usar en todo el mundo:

### 📦 Paquetes Python listos para usar
*   **Ruedas (`.whl`) disponibles**: ahora el proyecto está preparado para generar distribuciones wheel con `python -m build --wheel`.
*   **Empaquetado moderno**: compatibilidad con PyQt6 y mejores metadatos en `pyproject.toml`.

### 🌍 Tu programa en cualquier idioma
Ahora es mucho más fácil que tu aplicación hable el idioma de tus usuarios:
*   **Detección automática:** El sistema detecta solo si tu computadora está en español, inglés, u otros idiomas.
*   **Soporte global:** Incluye paquetes para más de 10 regiones (Español, Inglés, Chino, Japonés, etc.).
*   **A prueba de errores:** Si el sistema no encuentra tu idioma, te avisará de forma clara en lugar de fallar.

### 🎨 Instalación más visual y sencilla
El proceso de instalación ahora es más amigable:
*   **Pantalla de bienvenida:** Verás una ventana de carga moderna al iniciar.
*   **Iconos dinámicos:** Dibujos animados que te guían en cada paso.
*   **Instalación local:** Puedes instalar el framework directamente desde los archivos descargados sin complicaciones.

---

## 🛠 Guía de Instalación Paso a Paso

No necesitas usar comandos complejos. Hemos creado un **asistente visual** que hará todo por ti:

1.  Abre la carpeta del proyecto en tu computadora.
2.  Abre una terminal o consola de comandos.
3.  Escribe el siguiente código y presiona **Enter**:

```bash
python leviathan-ui.py
```

*Esto abrirá una ventana que te guiará paso a paso, igual que cuando instalas cualquier otro programa en Windows.*

---

## 🎯 Ejemplo Rápido

```python
import sys
from PyQt6.QtWidgets import QApplication, QWidget, QVBoxLayout, QLabel
from leviathan_ui import CustomTitleBar, WipeWindow

class MiApp(QWidget):
    def __init__(self):
        super().__init__()
        self.resize(900, 550)
        
        # Aplicar efecto GhostBlur
        WipeWindow.create().set_mode("ghostBlur").set_radius(10).apply(self)
        
        layout = QVBoxLayout(self)
        layout.setContentsMargins(0, 0, 0, 0)
        
        # Barra de título personalizada
        self.title_bar = CustomTitleBar(self, title="Mi Aplicación")
        layout.addWidget(self.title_bar)
        
        # Contenido
        content = QLabel("¡Hola Mundo con Leviathan-UI!")
        content.setStyleSheet("color: white; font-size: 24px;")
        layout.addWidget(content)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MiApp()
    window.show()
    sys.exit(app.exec())
```

---

## 📦 Scripts de Demo Incluidos

Prueba los diferentes estilos visuales:

```bash
python lvthnUi.ghost.py      # Efecto Ghost transparente
python lvthnUi.ghostBlur.py   # Efecto Ghost con desenfoque
python lvthnUi.polished.py    # Estilo pulido con sombras
python lvthnUI.dialogBox.py   # Diálogos personalizados
```
