@polymorphism-tech/morph-spec 3.1.0 → 4.2.0

package/stacks/blazor-azure/.morph/templates/test.cs

@@ -1,239 +0,0 @@
-// ============================================================
-// TEST TEMPLATE
-// Generated by MORPH Framework
-// ============================================================
-
-using FluentAssertions;
-using Microsoft.Extensions.Logging;
-using NSubstitute;
-using Xunit;
-
-namespace MyProject.Tests.Unit.Features.{Feature};
-
-/// <summary>
-/// Unit tests for {Feature}Service.
-/// </summary>
-public class {Feature}ServiceTests
-{
-    private readonly I{Feature}Repository _repository;
-    private readonly ILogger<{Feature}Service> _logger;
-    private readonly {Feature}Service _sut;
-
-    public {Feature}ServiceTests()
-    {
-        _repository = Substitute.For<I{Feature}Repository>();
-        _logger = Substitute.For<ILogger<{Feature}Service>>();
-        _sut = new {Feature}Service(_repository, _logger);
-    }
-
-    #region GetByIdAsync Tests
-
-    [Fact]
-    public async Task GetByIdAsync_WithValidId_ReturnsDto()
-    {
-        // Arrange
-        var id = 1;
-        var entity = CreateTestEntity(id, "Test {Feature}");
-        _repository.GetByIdAsync(id, Arg.Any<CancellationToken>())
-            .Returns(entity);
-
-        // Act
-        var result = await _sut.GetByIdAsync(id);
-
-        // Assert
-        result.Should().NotBeNull();
-        result!.Id.Should().Be(id);
-        result.Name.Should().Be("Test {Feature}");
-    }
-
-    [Fact]
-    public async Task GetByIdAsync_WithInvalidId_ReturnsNull()
-    {
-        // Arrange
-        var id = 999;
-        _repository.GetByIdAsync(id, Arg.Any<CancellationToken>())
-            .Returns((Domain.Entities.{Feature}?)null);
-
-        // Act
-        var result = await _sut.GetByIdAsync(id);
-
-        // Assert
-        result.Should().BeNull();
-    }
-
-    #endregion
-
-    #region GetAllAsync Tests
-
-    [Fact]
-    public async Task GetAllAsync_ReturnsAllItems()
-    {
-        // Arrange
-        var entities = new List<Domain.Entities.{Feature}>
-        {
-            CreateTestEntity(1, "First"),
-            CreateTestEntity(2, "Second"),
-            CreateTestEntity(3, "Third")
-        };
-        _repository.GetAllAsync(Arg.Any<CancellationToken>())
-            .Returns(entities);
-
-        // Act
-        var result = await _sut.GetAllAsync();
-
-        // Assert
-        result.Should().HaveCount(3);
-        result[0].Name.Should().Be("First");
-    }
-
-    [Fact]
-    public async Task GetAllAsync_WithNoItems_ReturnsEmptyList()
-    {
-        // Arrange
-        _repository.GetAllAsync(Arg.Any<CancellationToken>())
-            .Returns(new List<Domain.Entities.{Feature}>());
-
-        // Act
-        var result = await _sut.GetAllAsync();
-
-        // Assert
-        result.Should().BeEmpty();
-    }
-
-    #endregion
-
-    #region CreateAsync Tests
-
-    [Fact]
-    public async Task CreateAsync_WithValidRequest_CreatesAndReturnsDto()
-    {
-        // Arrange
-        var request = new Create{Feature}Request("New {Feature}");
-
-        _repository
-            .When(x => x.AddAsync(Arg.Any<Domain.Entities.{Feature}>(), Arg.Any<CancellationToken>()))
-            .Do(x =>
-            {
-                // Simulate ID assignment
-                var entity = x.Arg<Domain.Entities.{Feature}>();
-                // entity.Id would be set by EF Core
-            });
-
-        // Act
-        var result = await _sut.CreateAsync(request);
-
-        // Assert
-        result.Should().NotBeNull();
-        result.Name.Should().Be("New {Feature}");
-
-        await _repository.Received(1).AddAsync(Arg.Any<Domain.Entities.{Feature}>(), Arg.Any<CancellationToken>());
-        await _repository.Received(1).SaveChangesAsync(Arg.Any<CancellationToken>());
-    }
-
-    [Theory]
-    [InlineData("")]
-    [InlineData(" ")]
-    [InlineData(null)]
-    public async Task CreateAsync_WithInvalidName_ThrowsValidationException(string? name)
-    {
-        // Arrange
-        var request = new Create{Feature}Request(name!);
-
-        // Act
-        var act = async () => await _sut.CreateAsync(request);
-
-        // Assert
-        await act.Should().ThrowAsync<ValidationException>();
-    }
-
-    #endregion
-
-    #region UpdateAsync Tests
-
-    [Fact]
-    public async Task UpdateAsync_WithValidRequest_UpdatesEntity()
-    {
-        // Arrange
-        var id = 1;
-        var entity = CreateTestEntity(id, "Original");
-        var request = new Update{Feature}Request("Updated");
-
-        _repository.GetByIdAsync(id, Arg.Any<CancellationToken>())
-            .Returns(entity);
-
-        // Act
-        await _sut.UpdateAsync(id, request);
-
-        // Assert
-        _repository.Received(1).Update(Arg.Any<Domain.Entities.{Feature}>());
-        await _repository.Received(1).SaveChangesAsync(Arg.Any<CancellationToken>());
-    }
-
-    [Fact]
-    public async Task UpdateAsync_WithNonExistentId_ThrowsNotFoundException()
-    {
-        // Arrange
-        var id = 999;
-        var request = new Update{Feature}Request("Updated");
-
-        _repository.GetByIdAsync(id, Arg.Any<CancellationToken>())
-            .Returns((Domain.Entities.{Feature}?)null);
-
-        // Act
-        var act = async () => await _sut.UpdateAsync(id, request);
-
-        // Assert
-        await act.Should().ThrowAsync<{Feature}NotFoundException>();
-    }
-
-    #endregion
-
-    #region DeleteAsync Tests
-
-    [Fact]
-    public async Task DeleteAsync_WithValidId_DeletesEntity()
-    {
-        // Arrange
-        var id = 1;
-        var entity = CreateTestEntity(id, "To Delete");
-
-        _repository.GetByIdAsync(id, Arg.Any<CancellationToken>())
-            .Returns(entity);
-
-        // Act
-        await _sut.DeleteAsync(id);
-
-        // Assert
-        _repository.Received(1).Remove(entity);
-        await _repository.Received(1).SaveChangesAsync(Arg.Any<CancellationToken>());
-    }
-
-    [Fact]
-    public async Task DeleteAsync_WithNonExistentId_ThrowsNotFoundException()
-    {
-        // Arrange
-        var id = 999;
-
-        _repository.GetByIdAsync(id, Arg.Any<CancellationToken>())
-            .Returns((Domain.Entities.{Feature}?)null);
-
-        // Act
-        var act = async () => await _sut.DeleteAsync(id);
-
-        // Assert
-        await act.Should().ThrowAsync<{Feature}NotFoundException>();
-    }
-
-    #endregion
-
-    #region Helper Methods
-
-    private static Domain.Entities.{Feature} CreateTestEntity(int id, string name)
-    {
-        return Domain.Entities.{Feature}.Create(name);
-        // Note: In real tests, you might need reflection to set the Id
-        // or use a factory method that accepts an id for testing
-    }
-
-    #endregion
-}

package/stacks/blazor-azure/.morph/templates/ui-components.md

@@ -1,362 +0,0 @@
-# UI Components - {{FEATURE_NAME_TITLE}}
-
-> Especificação dos componentes Fluent UI / MudBlazor utilizados nesta feature.
-> Mapeia cada elemento visual para um componente concreto da biblioteca escolhida.
-
----
-
-## Decisão de Biblioteca UI
-
-### Biblioteca Escolhida: {Fluent UI Blazor | MudBlazor | Híbrida}
-
-**Justificativa:**
-{Por que esta biblioteca foi escolhida para ESTA feature específica?}
-
-**Critérios de decisão:**
-- ✅ **{Critério 1}**: {Explicação}
-- ✅ **{Critério 2}**: {Explicação}
-- ⚠️ **{Trade-off}**: {O que foi sacrificado e por quê}
-
-**Referência ADR**: Ver `decisions.md` - ADR-{número}: {Título da decisão}
-
----
-
-## Componentes Mapeados
-
-### {Nome do Elemento Visual}
-
-**Biblioteca**: {Fluent UI | MudBlazor}
-**Componente**: `{ComponentName}`
-
-#### Props Principais
-```csharp
-<{ComponentName}
-    Prop1="{valor ou @binding}"
-    Prop2="{valor ou @binding}"
-    Prop3="{valor ou @binding}"
-    OnClick="@{Handler}" />
-```
-
-#### Propriedades Detalhadas
-| Prop | Tipo | Valor | Descrição |
-|------|------|-------|-----------|
-| `Prop1` | `string` | `"{valor}"` | {Para que serve} |
-| `Prop2` | `bool` | `true` | {Para que serve} |
-| `Prop3` | `EventCallback` | `@Handler` | {Quando dispara} |
-
-#### Estados
-
-**1. Default (Estado Inicial)**
-```razor
-<{ComponentName}
-    Appearance="Appearance.Neutral"
-    Disabled="false">
-    {Conteúdo padrão}
-</{ComponentName}>
-```
-
-**2. Loading**
-```razor
-@if (_isLoading)
-{
-    <FluentSkeleton Width="100%" Height="40px" />
-    <!-- OU -->
-    <FluentProgress />
-}
-else
-{
-    <{ComponentName} ... />
-}
-```
-
-**3. Error**
-```razor
-@if (!string.IsNullOrEmpty(_error))
-{
-    <FluentMessageBar Intent="MessageIntent.Error">
-        @_error
-    </FluentMessageBar>
-}
-<{ComponentName} ... />
-```
-
-**4. Empty (Sem Dados)**
-```razor
-@if (!_items.Any())
-{
-    <FluentStack Orientation="Orientation.Vertical" HorizontalAlignment="HorizontalAlignment.Center">
-        <FluentLabel>Nenhum item encontrado</FluentLabel>
-        <FluentButton Appearance="Appearance.Accent" OnClick="@Create">
-            Criar Novo
-        </FluentButton>
-    </FluentStack>
-}
-```
-
-**5. Success (Feedback Positivo)**
-```razor
-<FluentToast Intent="ToastIntent.Success" Timeout="3000">
-    Operação realizada com sucesso!
-</FluentToast>
-```
-
-#### Eventos
-
-| Evento | Handler | Ação |
-|--------|---------|------|
-| `OnClick` | `HandleClick` | {O que acontece ao clicar} |
-| `OnChange` | `HandleChange` | {O que acontece ao mudar valor} |
-| `OnSubmit` | `HandleSubmit` | {O que acontece ao submeter} |
-
-#### Exemplo de Código Completo
-
-```razor
-<!-- {Nome do Componente}.razor -->
-<{ComponentName}
-    Items="@_items"
-    Loading="@_isLoading"
-    OnClick="@HandleClick">
-
-    @if (_isLoading)
-    {
-        <FluentProgress />
-    }
-    else
-    {
-        @foreach (var item in _items)
-        {
-            <{ChildComponent} Data="@item" />
-        }
-    }
-</{ComponentName}>
-
-@code {
-    [Parameter] public List<ItemType> Items { get; set; } = new();
-
-    private bool _isLoading;
-    private string? _error;
-
-    protected override async Task OnInitializedAsync()
-    {
-        await LoadDataAsync();
-    }
-
-    private async Task LoadDataAsync()
-    {
-        _isLoading = true;
-        try
-        {
-            _items = await _service.GetItemsAsync();
-        }
-        catch (Exception ex)
-        {
-            _error = ex.Message;
-        }
-        finally
-        {
-            _isLoading = false;
-        }
-    }
-
-    private async Task HandleClick(ItemType item)
-    {
-        // Ação ao clicar
-    }
-}
-```
-
-#### Acessibilidade
-
-**ARIA Attributes:**
-- `role="{role}"`: {Propósito}
-- `aria-label="{label}"`: {Descrição para screen readers}
-- `aria-describedby="{id}"`: {Descrição adicional}
-
-**Keyboard Navigation:**
-- `Tab`: {Foca no elemento}
-- `Enter/Space`: {Ativa o elemento}
-- `Escape`: {Cancela/fecha}
-- `Arrow Keys`: {Navega entre opções}
-
-**Focus Management:**
-- **Foco inicial**: {Onde o foco deve ir quando o componente aparece}
-- **Focus trap**: {Se aplicável, como manter o foco dentro do componente (modals)}
-
----
-
-## {Próximo Componente}
-
-{Repita a estrutura acima para cada componente}
-
----
-
-## Componentes Customizados
-
-### {Nome do Componente Custom}
-
-Se você precisar criar um componente que NÃO existe em Fluent UI ou MudBlazor:
-
-**Composição:**
-```razor
-<!-- Components/{ComponentName}.razor -->
-<div class="custom-component">
-    <FluentCard>
-        <FluentStack Orientation="Orientation.Vertical">
-            <!-- Composição de componentes existentes -->
-        </FluentStack>
-    </FluentCard>
-</div>
-
-@code {
-    // Lógica do componente
-}
-```
-
-**Quando usar:**
-- {Situação 1 que justifica componente custom}
-- {Situação 2}
-
----
-
-## Packages Necessários
-
-### Fluent UI Blazor
-```xml
-<PackageReference Include="Microsoft.FluentUI.AspNetCore.Components" Version="4.0.0" />
-```
-
-```csharp
-// Program.cs
-builder.Services.AddFluentUIComponents();
-```
-
-```razor
-// _Imports.razor
-@using Microsoft.FluentUI.AspNetCore.Components
-```
-
-### MudBlazor (se híbrido)
-```xml
-<PackageReference Include="MudBlazor" Version="6.11.0" />
-```
-
-```csharp
-// Program.cs
-builder.Services.AddMudServices();
-```
-
-```razor
-// _Imports.razor
-@using MudBlazor
-```
-
----
-
-## Mapa de Componentes
-
-Resumo visual de quais componentes são usados onde:
-
-| Tela/Feature | Componente | Biblioteca | Complexidade |
-|--------------|------------|------------|--------------|
-| {Tela 1} | FluentDataGrid | Fluent UI | Média |
-| {Tela 1} | FluentCard | Fluent UI | Baixa |
-| {Tela 2} | MudChart | MudBlazor | Alta |
-| {Tela 2} | FluentDialog | Fluent UI | Média |
-
----
-
----
-
-## Checklist de Componentes CSS
-
-> **IMPORTANTE:** Liste TODOS os componentes CSS necessarios ANTES de implementar.
-> Use `morph-spec validate-css` para validar que todas as classes existem.
-
-### Componentes CSS Novos (a criar)
-
-Classes CSS customizadas que precisam ser criadas no `design-system.css`:
-
-- [ ] `.{page-prefix}-{component}` - {Descricao do componente}
-- [ ] `.{page-prefix}-{element}` - {Descricao do elemento}
-
-**Exemplo:**
-```markdown
-- [ ] `.home-hero` - Container do hero section da home
-- [ ] `.home-features` - Grid de features
-- [ ] `.checkout-form` - Container do formulario de checkout
-- [ ] `.checkout-summary` - Card de resumo do pedido
-- [ ] `.modal-overlay` - Overlay escuro para modais customizados
-- [ ] `.modal-container` - Container do modal com animacao
-- [ ] `.card-premium` - Card com glow e borda especial
-- [ ] `.button-shimmer` - Botao com efeito shimmer
-```
-
-### Componentes CSS Existentes (reutilizar)
-
-Classes que ja existem no projeto (design-system.css ou bibliotecas):
-
-- [x] `.{existing-class}` - {Onde esta definida}
-
-**Exemplo:**
-```markdown
-- [x] `.page-layout` - design-system.css (estrutura padrao)
-- [x] `.tip-box` - design-system.css (caixa de dica)
-- [x] `FluentCard` - Fluent UI Blazor (componente)
-```
-
-### Variaveis CSS Novas
-
-Variaveis CSS customizadas necessarias:
-
-- [ ] `--{project}-{variable-name}` - {Descricao e valor}
-
-**Exemplo:**
-```markdown
-- [ ] `--fishart-primary` - Cor primaria (#FF6B35)
-- [ ] `--fishart-shadow-glow` - Sombra com glow (0 0 20px rgba(255, 107, 53, 0.3))
-- [ ] `--fishart-gradient-hero` - Gradiente do hero (linear-gradient(...))
-- [ ] `--fishart-transition-bounce` - Transicao com bounce (cubic-bezier(...))
-```
-
-### Animacoes CSS Novas
-
-Keyframes e classes de animacao necessarias:
-
-- [ ] `@keyframes {animation-name}` - {Descricao}
-- [ ] `.animate-{name}` - Classe que aplica a animacao
-
-**Exemplo:**
-```markdown
-- [ ] `@keyframes slideInUp` - Entrada de baixo para cima
-- [ ] `.animate-slideInUp` - Aplica slideInUp com 0.5s ease
-- [ ] `@keyframes scaleIn` - Zoom in suave
-- [ ] `.animate-scaleIn` - Aplica scaleIn com 0.3s ease
-- [ ] `.stagger-1` a `.stagger-5` - Delays para animacoes em sequencia
-```
-
-### Validacao Pre-Implementacao
-
-Antes de iniciar FASE 5 (IMPLEMENT), validar:
-
-```bash
-# Criar todas as classes listadas acima no design-system.css
-
-# Validar que nenhuma classe esta faltando
-morph-spec validate-css src/MyApp.Web
-
-# Output esperado: "All CSS classes are properly defined!"
-```
-
----
-
-## Referências
-
-- [Fluent UI Components](https://www.fluentui-blazor.net/Components)
-- [MudBlazor Components](https://mudblazor.com/components/list)
-- [Guia Fluent UI Blazor](../../framework/standards/fluent-ui-blazor.md)
-- [CSS Naming Convention](../../framework/standards/css-naming.md)
-- [CSS Animations](../../framework/standards/css-animations.md)
-
----
-
-*Template MORPH-SPEC v2.2.0 by Polymorphism Tech*