Metadata-Version: 2.4
Name: flet-wizards
Version: 0.1.0
Summary: Multi-step wizard templates for Flet apps — auth, profile, and gallery showcase
Project-URL: Homepage, https://github.com/Alisonsantos77/flet-wizards
Project-URL: Repository, https://github.com/Alisonsantos77/flet-wizards
Project-URL: Issues, https://github.com/Alisonsantos77/flet-wizards/issues
Author-email: Alison Santos <aprovaxsistemaconcursos@gmail.com>
License: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: User Interfaces
Requires-Python: >=3.12
Requires-Dist: flet>=0.85.0
Requires-Dist: loguru>=0.7.3
Provides-Extra: pipeline
Requires-Dist: openai>=1.0.0; extra == 'pipeline'
Description-Content-Type: text/markdown

# flet-wizards

[![Python](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/)
[![Flet](https://img.shields.io/badge/flet-0.85+-purple.svg)](https://flet.dev)
[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://opensource.org/licenses/MIT)

Coleção de templates de wizard multi-step prontos para reutilizar em apps Flet.
Cada template é uma `@ft.component` autocontida com estado reativo (`@ft.observable`),
sistema de temas (Slate / Emerald / Rose / Azure), validação de plataforma e callback
`on_complete` tipado. Inclui um gallery showcase estilo Microsoft Store para visualizar
todos os templates ao vivo durante o desenvolvimento.

## Templates disponíveis

| Categoria | Nome | Steps | Descrição |
|-----------|------|-------|-----------|
| auth | [Login Clássico](docs/auth/login.md) | 2 | Wizard de login com e-mail e senha em dois steps. |
| auth | [Recuperar Senha](docs/auth/recovery.md) | 3 | Wizard de recuperação de senha com código de verificação. |
| auth | [Cadastro](docs/auth/register.md) | 3 | Wizard de cadastro com conta, perfil e confirmação. |
| profile | [Avatar](docs/profile/avatar.md) | 3 | Wizard de configuração de avatar com 3 origens (arquivo, URL, iniciais). |
| profile | [Editar Perfil](docs/profile/edit.md) | 3 | Wizard de edição de perfil com diff visual no resumo. |
| profile | [Setup de Perfil](docs/profile/setup.md) | 3 | Wizard de onboarding com identidade, interesses e preferências. |

## Instalação

```bash
# em breve no PyPI
# pip install flet-wizards
```

Por enquanto, clone o repo e use `uv sync` para instalar as dependências.

## Uso rápido

```python
import flet as ft
from flet_wizards.auth.login import AuthLoginWizard

async def main(page: ft.Page):
    page.render(lambda: AuthLoginWizard(on_complete=lambda d: print(d)))

ft.run(main)
```

## Gallery

```powershell
uv run flet run
```

Abre o showcase com sidebar por categoria, seletor de tema (4 paletas) e preview ao vivo de cada template.

---

_Documentação regenerada automaticamente por `pipeline/cocoindex_pipeline.py`._
