leviathan-ui 1.0.0__tar.gz

leviathan_ui-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jesus Quijada
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

leviathan_ui-1.0.0/PKG-INFO

@@ -0,0 +1,167 @@
+Metadata-Version: 2.4
+Name: leviathan-ui
+Version: 1.0.0
+Summary: Premium UI framework for PyQt5 with Windows 11 aesthetics, blur effects, and modern splash screens
+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: pyqt5,ui,windows11,blur,splash,frameless,modern-ui
+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: PyQt5>=5.15.0
+Requires-Dist: Pillow>=9.0.0
+Dynamic: license-file
+
+# Leviathan UI
+
+**Premium UI Framework for PyQt5 with Windows 11 Aesthetics**
+
+A modern, feature-rich UI framework that brings Windows 11's beautiful design language to your PyQt5 applications.
+
+## ✨ Features
+
+- **🪟 WipeWindow**: Three stunning window modes
+  - `polished`: Solid background with shadows and rounded corners
+  - `ghost`: Fully transparent overlay mode
+  - `ghostBlur`: Acrylic/frosted glass blur effect (Windows 10/11)
+
+- **🌊 InmersiveSplash**: Professional splash screen system
+  - Adaptive mode (respects taskbar) and fullscreen mode
+  - Custom phrases for startup and exit
+  - Smooth fade animations
+  - Automatic lifecycle management
+
+- **🎨 CustomTitleBar**: Windows 11 style title bar
+  - Native SVG-drawn window controls
+  - System accent color integration
+  - Smooth drag and maximize/minimize
+
+- **🎭 InmojiTrx**: High-quality icon generation
+  - Convert emojis to multi-resolution ICO files
+  - Support for PNG/ICO images
+  - Perfect taskbar rendering
+
+## 📦 Installation
+
+```bash
+pip install leviathan-ui
+```
+
+Or install from wheel:
+```bash
+pip install leviathan_ui-1.0.0-py3-none-any.whl
+```
+
+## 🚀 Quick Start
+
+```python
+from PyQt5.QtWidgets import QApplication, QWidget
+from leviathan_ui import WipeWindow, InmersiveSplash, CustomTitleBar, InmojiTrx
+
+app = QApplication([])
+
+# Create your main window
+window = QWidget()
+window.resize(800, 600)
+
+# Apply blur effect
+WipeWindow.create()\
+    .set_mode("ghostBlur")\
+    .set_radius(15)\
+    .apply(window)
+
+# Add custom title bar
+title_bar = CustomTitleBar(window, title="My App")
+
+# Set app icon
+InmojiTrx("🚀").apply(app)
+
+# Create splash screen
+splash = InmersiveSplash.create()\
+    .set_mode("adaptive")\
+    .set_phrases(["Loading modules...", "Ready!"])\
+    .on_finish(window.show)\
+    .start()
+
+app.exec_()
+```
+
+## 📖 Documentation
+
+### WipeWindow
+
+```python
+WipeWindow.create()\
+    .set_mode("polished")      # "polished", "ghost", or "ghostBlur"
+    .set_background("auto")     # "auto" or hex color "#RRGGBB"
+    .set_radius(20)             # Corner radius in pixels
+    .set_blur(30)               # Blur intensity (ghostBlur mode only)
+    .apply(widget)
+```
+
+### InmersiveSplash
+
+```python
+InmersiveSplash.create()\
+    .set_mode("adaptive")       # "adaptive" or "full"
+    .set_color("auto")          # "auto" or hex color
+    .set_phrases([...])         # List of status messages
+    .on_finish(callback)        # Function to call when done
+    .attach_to_window(win, exit_phrases=[...])  # Auto exit splash
+    .start()
+```
+
+### CustomTitleBar
+
+```python
+title_bar = CustomTitleBar(
+    parent=window,
+    title="My Application",
+    icon="🎨"
+)
+```
+
+### InmojiTrx
+
+```python
+# From emoji
+InmojiTrx("🐉").apply(app)
+
+# From image file
+InmojiTrx("icon.png").apply(app)
+```
+
+## 🎯 Requirements
+
+- Python 3.8+
+- PyQt5 >= 5.15.0
+- Pillow >= 9.0.0
+- Windows 10/11 (for blur effects)
+
+## 📄 License
+
+MIT License - feel free to use in your projects!
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## ⭐ Credits
+
+Created by Jesus Quijada

leviathan_ui-1.0.0/README.md

@@ -0,0 +1,137 @@
+# Leviathan UI
+
+**Premium UI Framework for PyQt5 with Windows 11 Aesthetics**
+
+A modern, feature-rich UI framework that brings Windows 11's beautiful design language to your PyQt5 applications.
+
+## ✨ Features
+
+- **🪟 WipeWindow**: Three stunning window modes
+  - `polished`: Solid background with shadows and rounded corners
+  - `ghost`: Fully transparent overlay mode
+  - `ghostBlur`: Acrylic/frosted glass blur effect (Windows 10/11)
+
+- **🌊 InmersiveSplash**: Professional splash screen system
+  - Adaptive mode (respects taskbar) and fullscreen mode
+  - Custom phrases for startup and exit
+  - Smooth fade animations
+  - Automatic lifecycle management
+
+- **🎨 CustomTitleBar**: Windows 11 style title bar
+  - Native SVG-drawn window controls
+  - System accent color integration
+  - Smooth drag and maximize/minimize
+
+- **🎭 InmojiTrx**: High-quality icon generation
+  - Convert emojis to multi-resolution ICO files
+  - Support for PNG/ICO images
+  - Perfect taskbar rendering
+
+## 📦 Installation
+
+```bash
+pip install leviathan-ui
+```
+
+Or install from wheel:
+```bash
+pip install leviathan_ui-1.0.0-py3-none-any.whl
+```
+
+## 🚀 Quick Start
+
+```python
+from PyQt5.QtWidgets import QApplication, QWidget
+from leviathan_ui import WipeWindow, InmersiveSplash, CustomTitleBar, InmojiTrx
+
+app = QApplication([])
+
+# Create your main window
+window = QWidget()
+window.resize(800, 600)
+
+# Apply blur effect
+WipeWindow.create()\
+    .set_mode("ghostBlur")\
+    .set_radius(15)\
+    .apply(window)
+
+# Add custom title bar
+title_bar = CustomTitleBar(window, title="My App")
+
+# Set app icon
+InmojiTrx("🚀").apply(app)
+
+# Create splash screen
+splash = InmersiveSplash.create()\
+    .set_mode("adaptive")\
+    .set_phrases(["Loading modules...", "Ready!"])\
+    .on_finish(window.show)\
+    .start()
+
+app.exec_()
+```
+
+## 📖 Documentation
+
+### WipeWindow
+
+```python
+WipeWindow.create()\
+    .set_mode("polished")      # "polished", "ghost", or "ghostBlur"
+    .set_background("auto")     # "auto" or hex color "#RRGGBB"
+    .set_radius(20)             # Corner radius in pixels
+    .set_blur(30)               # Blur intensity (ghostBlur mode only)
+    .apply(widget)
+```
+
+### InmersiveSplash
+
+```python
+InmersiveSplash.create()\
+    .set_mode("adaptive")       # "adaptive" or "full"
+    .set_color("auto")          # "auto" or hex color
+    .set_phrases([...])         # List of status messages
+    .on_finish(callback)        # Function to call when done
+    .attach_to_window(win, exit_phrases=[...])  # Auto exit splash
+    .start()
+```
+
+### CustomTitleBar
+
+```python
+title_bar = CustomTitleBar(
+    parent=window,
+    title="My Application",
+    icon="🎨"
+)
+```
+
+### InmojiTrx
+
+```python
+# From emoji
+InmojiTrx("🐉").apply(app)
+
+# From image file
+InmojiTrx("icon.png").apply(app)
+```
+
+## 🎯 Requirements
+
+- Python 3.8+
+- PyQt5 >= 5.15.0
+- Pillow >= 9.0.0
+- Windows 10/11 (for blur effects)
+
+## 📄 License
+
+MIT License - feel free to use in your projects!
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## ⭐ Credits
+
+Created by Jesus Quijada

leviathan_ui-1.0.0/leviathan_ui/__init__.py

@@ -0,0 +1,6 @@
+from .splash import InmersiveSplash
+from .title_bar import CustomTitleBar, get_accent_color
+from .inmojiTrx import InmojiTrx
+from .wipeWindow import WipeWindow
+from .lightsOff import LightsOff
+from .dialogs import LeviathanDialog

leviathan_ui-1.0.0/leviathan_ui/debug.py

@@ -0,0 +1,52 @@
+import logging
+import traceback
+import sys
+import os
+from datetime import datetime
+
+class LeviathanDebugger:
+    """
+    Herramienta de depuración robusta para Leviathan.
+    Captura errores inesperados y los muestra de forma legible.
+    """
+    @staticmethod
+    def setup_logging(log_file="debug.log"):
+        try:
+            logging.basicConfig(
+                level=logging.DEBUG,
+                format='%(asctime)s [%(levelname)s] %(name)s: %(message)s',
+                handlers=[
+                    logging.FileHandler(log_file, encoding='utf-8'),
+                    logging.StreamHandler(sys.stdout)
+                ]
+            )
+        except Exception as e:
+            print(f"⚠️ No se pudo iniciar el logging: {e}")
+
+    @staticmethod
+    def parse_error(e):
+        """Devuelve un resumen formateado del error para la terminal."""
+        ts = datetime.now().strftime("%H:%M:%S")
+        error_type = type(e).__name__
+        msg = str(e)
+        tb = traceback.format_exc()
+        return f"\n{'='*50}\n[{ts}] ❌ ERROR ({error_type}): {msg}\n--- TRACEBACK ---\n{tb}{'='*50}\n"
+
+def _handle_exception(exc_type, exc_value, exc_traceback):
+    """Manejador global de excepciones no capturadas."""
+    if issubclass(exc_type, KeyboardInterrupt):
+        sys.__excepthook__(exc_type, exc_value, exc_traceback)
+        return
+    
+    error_msg = LeviathanDebugger.parse_error(exc_value)
+    logging.critical("Excepción no capturada:", exc_info=(exc_type, exc_value, exc_traceback))
+    print(error_msg, file=sys.stderr)
+
+def install_debugger(log_file="debug.log"):
+    """
+    Instala el sistema de depuración global. 
+    Llama a esto al principio de tu archivo principal.
+    """
+    sys.excepthook = _handle_exception
+    LeviathanDebugger.setup_logging(log_file)
+    print("🚀 Depurador Leviathan Activado")

leviathan_ui-1.0.0/leviathan_ui/dialogs.py

@@ -0,0 +1,174 @@
+import sys
+from PyQt5.QtWidgets import (QWidget, QVBoxLayout, QHBoxLayout, QLabel, 
+                             QPushButton, QApplication, QFrame)
+from PyQt5.QtCore import Qt, QPropertyAnimation, QEasingCurve, QRect, QPoint, QEvent
+from PyQt5.QtGui import QFont, QColor
+
+from .title_bar import CustomTitleBar, get_accent_color
+from .wipeWindow import WipeWindow
+from .lightsOff import LightsOff
+
+class LeviathanDialog(QWidget):
+    """
+    💠 LeviathanDialog: Reemplazo moderno para QMessageBox.
+    Integra Blur Overlay, TitleBar personalizada y efecto LightsOff.
+    """
+    
+    TYPES = {
+        "info": {"icon": "ℹ️", "color": "auto"},
+        "success": {"icon": "✅", "color": "#28a745"},
+        "warning": {"icon": "⚠️", "color": "#ffc107"},
+        "error": {"icon": "❌", "color": "#dc3545"}
+    }
+
+    def __init__(self, parent, title, message, mode="info", buttons=None):
+        super().__init__(None) # Dialog flotante
+        self._parent_win = parent
+        self._mode_cfg = self.TYPES.get(mode, self.TYPES["info"])
+        self._accent = get_accent_color() if self._mode_cfg["color"] == "auto" else self._mode_cfg["color"]
+        self._buttons = buttons or ["ENTENDIDO"]
+        self._result = None
+        self._callback = None
+        
+        self.setWindowTitle(title)
+        self.setFixedSize(450, 240)
+        self.setWindowModality(Qt.WindowModal if parent else Qt.NonModal)
+        self.setWindowFlags(self.windowFlags() | Qt.WindowStaysOnTopHint)
+        
+        # 1. Overlay Blur (Cubre la ventana principal)
+        if self._parent_win:
+            self.overlay = QWidget(self._parent_win)
+            self.overlay.setGeometry(self._parent_win.rect())
+            # Nos aseguramos que el overlay redimensione con el padre
+            self._parent_win.installEventFilter(self) 
+            WipeWindow.create().set_mode("ghostBlur").set_blur(40).apply(self.overlay)
+            self.overlay.show()
+        else:
+            self.overlay = None
+
+        # 2. Configuración de Ventana (WipeWindow)
+        WipeWindow.create()\
+            .set_mode("polished")\
+            .set_background("#181818")\
+            .set_radius(20)\
+            .apply(self)
+        
+        # 3. Layout Principal
+        self.main_layout = QVBoxLayout(self)
+        self.main_layout.setContentsMargins(0, 0, 0, 0)
+        self.main_layout.setSpacing(0)
+        
+        # Barra de Título
+        self.title_bar = CustomTitleBar(self, title=title, icon=self._mode_cfg["icon"])
+        self.main_layout.addWidget(self.title_bar)
+        
+        # Contenido
+        content_frame = QFrame()
+        content_lay = QVBoxLayout(content_frame)
+        content_lay.setContentsMargins(30, 20, 30, 25)
+        content_lay.setSpacing(20)
+        
+        msg_lay = QHBoxLayout()
+        icon_lbl = QLabel(self._mode_cfg["icon"])
+        icon_lbl.setFont(QFont("Segoe UI Emoji", 32))
+        icon_lbl.setStyleSheet("background: transparent;")
+        
+        self.msg_lbl = QLabel(message)
+        self.msg_lbl.setWordWrap(True)
+        self.msg_lbl.setStyleSheet("color: #eeeeee; font-size: 14px; font-family: 'Segoe UI'; background: transparent;")
+        
+        msg_lay.addWidget(icon_lbl)
+        msg_lay.addSpacing(15)
+        msg_lay.addWidget(self.msg_lbl, 1)
+        content_lay.addLayout(msg_lay)
+        
+        # Botones Dinámicos
+        btn_container = QHBoxLayout()
+        btn_container.addStretch()
+        
+        for btn_text in self._buttons:
+            btn = QPushButton(btn_text)
+            btn.setFixedSize(110, 36)
+            
+            # Estilo basado en acento
+            is_main = btn_text == self._buttons[-1]
+            bg = self._accent if is_main else "transparent"
+            fg = "black" if is_main else "white"
+            border = f"2px solid {self._accent}"
+            
+            btn.setStyleSheet(f"""
+                QPushButton {{
+                    background-color: {bg};
+                    color: {fg};
+                    border: {border};
+                    border-radius: 8px;
+                    font-weight: bold;
+                    font-family: 'Segoe UI';
+                }}
+                QPushButton:hover {{
+                    background-color: white;
+                    color: black;
+                    border: 2px solid white;
+                }}
+            """)
+            
+            # Efecto Glow
+            LightsOff.light_up(btn, color=self._accent if not is_main else "#ffffff", intensity=15)
+            
+            btn.clicked.connect(lambda checked, t=btn_text: self._on_btn_clicked(t))
+            btn_container.addWidget(btn)
+        
+        content_lay.addLayout(btn_container)
+        self.main_layout.addWidget(content_frame)
+        
+        # Centrar respecto al padre
+        self._update_position()
+            
+        # 5. Animaciones combinadas (Opacidad + Escala/Posición)
+        self.setWindowOpacity(0)
+        self.fade_anim = QPropertyAnimation(self, b"windowOpacity")
+        self.fade_anim.setDuration(350)
+        self.fade_anim.setStartValue(0)
+        self.fade_anim.setEndValue(1)
+        self.fade_anim.setEasingCurve(QEasingCurve.OutCubic)
+
+    def _update_position(self):
+        if self._parent_win:
+            center = self._parent_win.geometry().center()
+            self.move(center.x() - self.width() // 2, center.y() - self.height() // 2)
+
+    def eventFilter(self, obj, event):
+        # Sincronizar overlay con el padre si este cambia de tamaño
+        try:
+            if obj == self._parent_win and event.type() == QEvent.Resize:
+                if self.overlay: 
+                    self.overlay.setGeometry(self._parent_win.rect())
+        except: pass
+        return super().eventFilter(obj, event)
+
+    def _on_btn_clicked(self, text):
+        self._result = text
+        self.close()
+        # El callback se ejecuta DESPUÉS del close para que la UI esté limpia
+        if self._callback: self._callback(text)
+
+    def showEvent(self, event):
+        self.fade_anim.start()
+        super().showEvent(event)
+
+    def closeEvent(self, event):
+        # MUY IMPORTANTE: Remover el filtro antes de cerrar para evitar punteros rotos
+        if self._parent_win:
+            self._parent_win.removeEventFilter(self)
+        if self.overlay:
+            self.overlay.close()
+            self.overlay.deleteLater()
+        event.accept()
+        self.deleteLater() # Asegura que Python libere el objeto
+
+    @staticmethod
+    def launch(parent, title, message, mode="info", buttons=None, callback=None):
+        dlg = LeviathanDialog(parent, title, message, mode, buttons)
+        dlg._callback = callback
+        dlg.show()
+        return dlg

leviathan_ui-1.0.0/leviathan_ui/fixLights.py

@@ -0,0 +1,21 @@
+class FixLights:
+    """
+    🛠️ fixLights: Debugger especializado para el sistema de iluminación.
+    Verifica si los widgets tienen efectos aplicados y si las animaciones están listas.
+    """
+    @staticmethod
+    def audit(widget):
+        """Revisa la salud visual de un widget."""
+        has_effect = widget.graphicsEffect() is not None
+        status = "✅ OK" if has_effect else "❌ NO LIGHTS"
+        print(f"Audit [{widget.objectName() or 'Widget'}]: {status}")
+        return has_effect
+
+    @staticmethod
+    def fix_all(app):
+        """Intenta reaplicar efectos a todos los hijos de la app si fallan."""
+        from .lightsOff import light_up
+        for widget in app.allWidgets():
+            if not widget.graphicsEffect():
+                light_up(widget)
+        print("🛠️ fixLights: Iluminación restaurada en todos los controles.")