Jarvis.Blazor.Mud 1.1.6.9

Jarvis.Blazor.Mud

Biblioteca de componentes reutilizáveis para Blazor baseada no MudBlazor, oferecendo componentes de formulário, layouts, diálogos, serviços e autenticação prontos para uso.

Frameworks suportados: .NET 8.0 | .NET 9.0 | .NET 10.0

Instalação

dotnet add package Jarvis.Blazor.Mud

Configuração no Program.cs

// Registro básico (sem autenticação)
builder.Services.AddJarvisMud();

// Registro completo (com autenticação e upload de arquivos)
builder.Services.AddJarvisMud(options =>
{
    options.AppId = "minha-app";
    options.EndpointFile = "https://api.exemplo.com/upload";
});

// Ou de forma simplificada
builder.Services.AddJarvisMud("minha-app", "https://api.exemplo.com/upload");

Referências no index.html / App.razor

<link href="_content/Jarvis.Blazor.Uppy/uppy.min.css" rel="stylesheet" />
<link href="_content/Jarvis.Blazor.Quill/quill.min.css" rel="stylesheet" />
<link href="_content/Cropper.Blazor/cropper.min.css" rel="stylesheet" />


<script src="_content/Jarvis.Blazor.Mud/init.js"></script>
<script src="_content/Jarvis.Blazor.Uppy/uppy.min.js"></script>
<script src="_content/Jarvis.Blazor.Quill/quill.min.js"></script>
<script src="_content/Cropper.Blazor/cropper.min.js"></script>

Componentes de Formulário

Todos herdam de FormBase<T> e suportam two-way binding (@bind-Value), validação, helper text, modo read-only e layout horizontal/vertical.

Componentes de Layout

Diálogos

Serviços

Todos os serviços são registrados como Scoped via AddJarvisMud().

Autenticação

A biblioteca inclui um AuthenticationStateProvider baseado em tokens com persistência no Local Storage.

// Registrado automaticamente ao usar AddJarvisMud(options => ...)
services.AddScoped<AuthenticationStateProvider, JarvisAuthenticationStateProvider>();

Funcionalidades:

• Gerenciamento de estado de autenticação
• Persistência de token no Local Storage
• Refresh automático de token (TokenRefreshHandler)
• Redirecionamento para login quando token é inválido

Classes Base

CustomComponentBase

Classe base para todos os componentes customizados. Injeta automaticamente os serviços principais (Toast, Alert, Popup, Navigation, JSRuntime) e disponibiliza métodos HTTP auxiliares (GetAsync, PostAsync, PutAsync, DeleteAsync).

FormBase<T>

Classe base genérica para componentes de formulário. Suporta binding bidirecional, label, helper text, modo read-only e controle de layout.

PageBase

Classe base para páginas. Fornece acesso ao estado de autenticação, informações do usuário, parâmetros de query e gerenciamento de token.

Opções de Configuração

public class JarvisMudOptions
{
    public string AppId { get; set; }
    public string LoginPath { get; set; } = "/auth/login";
    public string LogoutPath { get; set; } = "/auth/logout";
    public string RecoverPasswordPath { get; set; } = "/auth/recuperar-senha";
    public string CreateAccountPath { get; set; } = "/auth/criar-cadastro";
    public string[] OthersPath { get; set; } = [];
    public string EndpointFile { get; set; }
    public IDictionary<string, string> HeadersEndpointFile { get; set; }
    public string DefaultImageSrc { get; set; } // Imagem placeholder padrão (base64)
}

Dependências