Metadata-Version: 2.4
Name: lumina-ui
Version: 0.6.0
Summary: Hardware-accelerated Neo-Bento and Frosted Glass UI framework for Python
Author: Aesterin
License: MIT
Project-URL: Homepage, https://github.com/your-username/lumina-ui
Project-URL: Repository, https://github.com/your-username/lumina-ui
Keywords: gui,ui,pyside6,qtquick,bento,neobento,dashboard
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
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: Topic :: Software Development :: User Interfaces
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: PySide6>=6.5.0

<div align="center">

# ⚡ Lumina UI

**Аппаратно-ускоренный Neo-Bento UI фреймворк для Python**

[![Python Version](https://img.shields.io/badge/python-3.9+-blue.svg?style=for-the-badge&logo=python&logoColor=white)](https://www.python.org/)
[![License](https://img.shields.io/badge/license-MIT-green.svg?style=for-the-badge)](LICENSE)
[![GUI Engine](https://img.shields.io/badge/engine-QtQuick%20%2F%20SceneGraph-7A5AF8.svg?style=for-the-badge)](https://www.qt.io/)
[![Style](https://img.shields.io/badge/style-Neo--Bento%20%26%20Glass-00F0FF.svg?style=for-the-badge)](#)

*Создавайте современные десктопные интерфейсы в эстетике Linear, Raycast и SCADA 2.0 без единой строчки QML или CSS.*

[Быстрый старт](#-быстрый-старт) • [Компоненты](#-коллекция-виджетов) • [Темы оформления](#-темы-оформления) • [Документация](#-документация-api)

<br/>

<img src="assets/banner.png" alt="Lumina UI Showcase" width="100%" style="border-radius: 12px; border: 1px solid #1C1F2B;"/>

</div>

---

## ✨ Ключевые особенности

- 💎 **Neo-Bento Aesthetic**: Глубокие бархатные фоны, субпиксельные полупрозрачные бордеры и динамическое неоновое свечение (Edge Glow) при наведении.
- 🚀 **Аппаратное ускорение (GPU)**: Отрисовка на базе Scene Graph (DirectX 12, Metal, Vulkan, OpenGL) со стабильными 60–144 FPS без задержек.
- 🪟 **Безрамочный дизайн из коробки**: Кастомный заголовок с поддержкой системного перетаскивания окна, навигацией и кнопками управления.
- 📐 **Декларативный синтаксис**: Вложенная структура на контекстных менеджерах Python (`with lm.Card():`).
- 🧭 **Два типа навигации**: Сворачиваемый компактный боковой рейл (`Sidebar`) и оверлейное выезжающее меню (`Drawer`).
- 🎨 **Мгновенные темы**: Переключение между темами `dark`, `gray` и `light` на лету с плавной анимацией палитры.
- 📊 **20+ готовых виджетов**: От векторных спарклайнов и спидометров до индикаторов антенны, заряда батареи и консоли логов.

---

## 📦 Установка

```bash
pip install lumina-ui
```

*Для локальной разработки:*
```bash
git clone [https://github.com/your-username/lumina-ui.git](https://github.com/your-username/lumina-ui.git)
cd lumina-ui
pip install -e .
```

---

## 🚀 Быстрый старт

Создайте приложение в 20 строк кода:

```python
import lumina as lm

app = lm.LuminaApp(title="Lumina Quickstart", width=1080, height=720, theme="dark")

with app:
    # Левая колонка
    with lm.Card(glow="purple", width=340):
        lm.Badge("SYSTEM OK", accent="emerald")
        lm.Label("Telemetry Monitor", size=18, bold=True)
        gauge = lm.RadialGauge(title="CPU LOAD", default=65, unit="%", accent="purple")
        lm.Button("Запустить аудит", accent="purple", on_click=lambda: app.notify("Audit", "Диагностика завершена!"))

    # Правая колонка
    with lm.Card(glow="cyan"):
        lm.Label("Control Matrix", size=18, bold=True)
        lm.SearchInput(placeholder="Поиск регистров или датчиков...", accent="cyan")
        lm.Slider(min_val=0, max_val=100, default=65, accent="cyan", on_change=lambda v: gauge.set_value(v))
        lm.Switch("High-Precision Polling", active=True, accent="cyan")

app.run()
```

---

## 🧩 Коллекция виджетов

| Категория | Компоненты |
| :--- | :--- |
| **Структура и сетка** | `LuminaApp`, `Card`, `Row`, `Sidebar`, `Drawer`, `Divider` |
| **Кнопки и выбор** | `Button`, `IconButton`, `NavButton`, `Switch`, `CheckBox`, `SegmentedControl`, `Dropdown` |
| **Ввод данных** | `Input`, `SearchInput`, `Slider` |
| **Индикаторы телеметрии** | `RadialGauge`, `TempMeter`, `SegmentBar` (VU-meter), `Sparkline`, `ProgressBar` |
| **Статусы и сенсоры** | `LEDIndicator`, `BatteryIndicator`, `SignalIndicator`, `Badge`, `StatTile`, `Metric` |
| **Логирование и текст** | `LogConsole`, `Label` |

---

## 🎨 Темы оформления

Переключение выполняется одной командой в любой момент работы:

```python
app.set_theme("dark")   # Velvet Black (глубокий чёрный с неоном)
app.set_theme("gray")   # Graphite / Titanium (матовый тёмно-серый)
app.set_theme("light")  # Frost Light (чистый светлый минимализм)
```

---

## 📄 Лицензия

Проект распространяется под лицензией [MIT](LICENSE). Разрешено коммерческое и некоммерческое использование.
