version 0.2, with auto properties.

Author: eglauko

README.md

@@ -1,2 +1,111 @@
 # SmartSelector
-Autoc selection expression generator to map object to object and apply to IQueryable.
+
+Gerador/Source Generator para criar automaticamente projeções (`Expression<Func<TFrom, TDto>>`), métodos auxiliares e propriedades em DTOs, reduzindo drasticamente boilerplate em consultas LINQ / EF Core.
+
+## Principais Recursos
+- `[AutoSelect<TFrom>]`: gera expressão de seleção, método `From`, extensões `Select{Dto}` / `To{Dto}`.
+- `[AutoProperties]` ou `[AutoProperties<TFrom>]`: gera propriedades simples automaticamente (primitivos, string, bool, DateTime, enum, struct, coleções simples `IEnumerable<T>` desses tipos).
+- Flattening por convenção: nomes concatenados em PascalCase resolvem cadeias aninhadas (ex.: `CustomerAddressCountryRegionName` ? `a.Customer.Address.Country.Region.Name`).
+- Exclusão de propriedades: `Exclude = [ nameof(Entity.Prop) ]`.
+- Diagnósticos de compilação para uso incorreto, tipos incompatíveis e conflitos.
+
+## Instalação
+```xml
+<ItemGroup>
+  <PackageReference Include="RoyalCode.SmartSelector" Version="x.y.z" />
+  <PackageReference Include="RoyalCode.SmartSelector.Generators" Version="x.y.z" OutputItemType="Analyzer" ReferenceOutputAssembly="false" />
+</ItemGroup>
+```
+
+## Exemplo 1 – Projeção Simples
+```csharp
+[AutoSelect<User>, AutoProperties]
+public partial class UserDetails { }
+
+// Uso
+var list = db.Users.SelectUserDetails().ToList();
+var dto  = UserDetails.From(user);
+var expr = UserDetails.SelectUserExpression; // reutilizável / componível
+```
+Código gerado (essencial):
+```csharp
+public static Expression<Func<User, UserDetails>> SelectUserExpression => u => new UserDetails { Id = u.Id, Name = u.Name };
+public static UserDetails From(User u) => (selectUserFunc ??= SelectUserExpression.Compile())(u);
+```
+
+## Exemplo 2 – Objeto Aninhado + Exclusão
+```csharp
+[AutoSelect<Book>, AutoProperties(Exclude = [ nameof(Book.Sku) ])]
+public partial class BookDetails
+{
+    public ShelfDetails Shelf { get; set; }
+}
+
+[AutoProperties<Shelf>]
+public partial class ShelfDetails { }
+```
+Trecho gerado:
+```csharp
+Shelf = new ShelfDetails { Id = a.Shelf.Id, Location = a.Shelf.Location },
+Price = a.Price,
+// Sku excluído
+```
+
+## Exemplo 3 – Flattening Profundo
+```csharp
+public class Order { public Customer Customer { get; set; } }
+// Customer -> Address -> Country -> Region
+[AutoSelect<Order>]
+public partial class OrderDetails
+{
+    public string CustomerAddressCountryRegionName { get; set; }
+}
+```
+Trecho da expressão:
+```csharp
+CustomerAddressCountryRegionName = a.Customer.Address.Country.Region.Name
+```
+
+## Regras de Flattening
+- Nome da propriedade = concatenação PascalCase dos segmentos do caminho.
+- Sem necessidade de atributos extras.
+
+## Tipos Suportados em AutoProperties
+- Primitivos numéricos, `bool`, `string`, `char`, `DateTime` / nullable simples
+- `enum`, `struct`
+- `IEnumerable<T>` onde `T` é suportado acima / enum / struct
+
+## Exclusões
+```csharp
+[AutoProperties<Product>(Exclude = [ nameof(Product.InternalCode), nameof(Product.Secret) ])]
+```
+
+## Diagnósticos Principais
+- Tipos inválidos ou classe não `partial` (`RCSS000`).
+- Propriedade não encontrada (`RCSS001`).
+- Tipos incompatíveis (`RCSS002`).
+- Uso incorreto de atributos (`RCSS003`–`RCSS005`).
+
+## Limitações Resumidas
+- Sem renome/alias explícito ainda (`MapFrom`).
+- Sem transformações de tipo (formatters / custom converters).
+- Desambiguação de flattening limitada em colisões de prefixo.
+
+## Boas Práticas
+- Use `nameof` em `Exclude`.
+- Prefira consumir a expressão gerada para reutilização e composição LINQ.
+- Para caminhos muito longos, avalie DTOs aninhados por clareza.
+
+## FAQ Rápido
+| Pergunta | Resposta |
+|----------|----------|
+| Preciso configurar algo no runtime? | Não, pura geração de código. |
+| Funciona com EF Core? | Sim, a expressão é traduzível. |
+| Posso só gerar propriedades? | Sim: `[AutoProperties<TFrom>]`. |
+| Flattening precisa de atributo? | Não, é por nome. |
+
+## Mais Informações
+Documentação detalhada: ver `docs.md` no repositório.
+
+---
+Happy coding!

src/AnalyzerReleases.Shipped.md

@@ -8,3 +8,5 @@ RCSS000  | Usage    | Error    | RCSS000_Invalid_model_type, [Documentation](htt
 RCSS001  | Usage    | Error    | RCSS001_It_is_not_possible_to_determine_a_corresponding_property_for_the_other_type, [Documentation](https://google.com)
 RCSS002  | Usage    | Error    | RCSS002_Incompatible_property_types, [Documentation](https://google.com)
 RCSS003  | Usage    | Error    | RCSS003_Invalid_auto_property, [Documentation](https://google.com)
+RCSS004  | Usage    | Error    | RCSS004_Conflict_auto_property_attribute, [Documentation](https://google.com)
+RCSS005  | Usage    | Error    | RCSS005_Invalid_auto_property_from, [Documentation](https://google.com)

src/Directory.Build.props

@@ -9,7 +9,7 @@
 		<ExtSrcGenVer>0.1.7</ExtSrcGenVer>
 	</PropertyGroup>
 	<PropertyGroup>
-		<Ver>0.1.0</Ver>
+		<Ver>0.2.0</Ver>
 		<Prev></Prev>
 	</PropertyGroup>
 </Project>

src/RoyalCode.SmartSelector.Demo/Details/Library/BookDetails.cs

@@ -5,6 +5,8 @@ namespace RoyalCode.SmartSelector.Demo.Details.Library;
 [AutoSelect<Book>, AutoProperties(Exclude = [ nameof(Book.Sku) ])]
 public partial class BookDetails
 {
-    public Guid Id { get; set; }
+    public ShelfDetails Shelf { get; set; }
 }
 
+[AutoProperties<Shelf>]
+public partial class ShelfDetails { }

src/RoyalCode.SmartSelector.Demo/Generated/RoyalCode.SmartSelector.Generators/RoyalCode.SmartSelector.Generators.IncrementalGenerator/BookDetails.AutoProperties.g.cs

@@ -3,6 +3,8 @@ namespace RoyalCode.SmartSelector.Demo.Details.Library;
 
 public partial class BookDetails
 {
+    public Guid Id { get; set; }
+
     public string Title { get; set; }
 
     public string Author { get; set; }

src/RoyalCode.SmartSelector.Demo/Generated/RoyalCode.SmartSelector.Generators/RoyalCode.SmartSelector.Generators.IncrementalGenerator/BookDetails.g.cs

@@ -9,6 +9,11 @@ public partial class BookDetails
 
     public static Expression<Func<Book, BookDetails>> SelectBookExpression { get; } = a => new BookDetails
     {
+        Shelf = new ShelfDetails
+        {
+            Id = a.Shelf.Id,
+            Location = a.Shelf.Location
+        },
         Id = a.Id,
         Title = a.Title,
         Author = a.Author,

src/RoyalCode.SmartSelector.Demo/Generated/RoyalCode.SmartSelector.Generators/RoyalCode.SmartSelector.Generators.IncrementalGenerator/ShelfDetails.AutoProperties.g.cs

@@ -0,0 +1,9 @@
+
+namespace RoyalCode.SmartSelector.Demo.Details.Library;
+
+public partial class ShelfDetails
+{
+    public Guid Id { get; set; }
+
+    public string Location { get; set; }
+}

src/RoyalCode.SmartSelector.Demo/Infra/AppDbContext.cs

@@ -2,6 +2,7 @@
 using Microsoft.EntityFrameworkCore;
 using RoyalCode.SmartSelector.Demo.Entities;
 using RoyalCode.SmartSelector.Demo.Entities.Blogs;
+using RoyalCode.SmartSelector.Demo.Entities.Library; // added for Book & Shelf
 
 namespace RoyalCode.SmartSelector.Demo.Infra;
 
@@ -25,6 +26,10 @@ public class AppDbContext : DbContext
 
     public DbSet<Author> Authors { get; set; } = default!;
 
+    public DbSet<Book> Books { get; set; } = default!;
+
+    public DbSet<Shelf> Shelves { get; set; } = default!;
+
     protected override void OnModelCreating(ModelBuilder modelBuilder)
     {
         modelBuilder.Entity<Product>().ToTable("Products");
@@ -36,6 +41,8 @@ protected override void OnModelCreating(ModelBuilder modelBuilder)
         modelBuilder.Entity<Post>().ToTable("Posts");
         modelBuilder.Entity<Comment>().ToTable("Comments");
         modelBuilder.Entity<Author>().ToTable("Authors");
+        modelBuilder.Entity<Book>().ToTable("Books");
+        modelBuilder.Entity<Shelf>().ToTable("Shelves");
     }
 
     protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)

src/RoyalCode.SmartSelector.Demo/Tests/BookDemoTests.cs

@@ -0,0 +1,94 @@
+namespace RoyalCode.SmartSelector.Demo.Tests;
+
+using RoyalCode.SmartSelector.Demo.Details.Library;
+using RoyalCode.SmartSelector.Demo.Entities.Library;
+using RoyalCode.SmartSelector.Demo.Infra;
+
+public class BookDemoTests
+{
+    [Fact]
+    public void GetSelectExpression()
+    {
+        // act
+        var expression = BookDetails.SelectBookExpression;
+
+        // assert
+        Assert.NotNull(expression);
+    }
+
+    [Fact]
+    public void Create_BookDetails_From_Book()
+    {
+        // arrange
+        var shelf = new Shelf { Location = "A-01" };
+        var book = new Book
+        {
+            Title = "DDD",
+            Author = "Eric Evans",
+            PublishedDate = new DateTime(2003, 8, 30),
+            ISBN = "1234567890",
+            Price = 99.90m,
+            InStock = true,
+            Sku = "SKU-123",
+            Shelf = shelf
+        };
+
+        // act
+        var details = BookDetails.From(book);
+
+        // assert
+        Assert.NotNull(details);
+        Assert.Equal(book.Id, details.Id);
+        Assert.Equal(book.Title, details.Title);
+        Assert.Equal(book.Author, details.Author);
+        Assert.Equal(book.PublishedDate, details.PublishedDate);
+        Assert.Equal(book.ISBN, details.ISBN);
+        Assert.Equal(book.Price, details.Price);
+        Assert.Equal(book.InStock, details.InStock);
+        // Sku excluído (não foi gerado)
+        // Propriedade Shelf (aninhada)
+        Assert.NotNull(details.Shelf);
+        Assert.Equal(book.Shelf.Id, details.Shelf.Id);
+        Assert.Equal(book.Shelf.Location, details.Shelf.Location);
+    }
+
+    [Fact]
+    public void Query_BookDetails_From_Database()
+    {
+        // arrange
+        var db = new AppDbContext();
+        db.Database.EnsureCreated();
+        var shelf = new Shelf { Location = "B-10" };
+        db.Shelves.Add(shelf);
+        db.Books.Add(new Book { Title = "Book 1", Author = "Author 1", PublishedDate = DateTime.Today, ISBN = "111", Price = 10m, InStock = true, Shelf = shelf });
+        db.Books.Add(new Book { Title = "Book 2", Author = "Author 2", PublishedDate = DateTime.Today, ISBN = "222", Price = 20m, InStock = false, Shelf = shelf });
+        db.SaveChanges();
+        db.ChangeTracker.Clear();
+
+        // act
+        var details = db.Books
+            .Select(BookDetails.SelectBookExpression)
+            .ToList();
+
+        // assert
+        Assert.Equal(2, details.Count);
+        Assert.Contains(details, d => d.Title == "Book 1" && d.Shelf.Location == "B-10");
+        Assert.Contains(details, d => d.Title == "Book 2" && d.Shelf.Location == "B-10");
+    }
+
+    [Fact]
+    public void Create_ShelfDetails_From_Shelf_Via_BookDetails_Nested()
+    {
+        // arrange
+        var shelf = new Shelf { Location = "C-15" };
+        var book = new Book { Title = "Nested", Author = "Author", PublishedDate = DateTime.Today, ISBN = "333", Price = 30m, InStock = true, Shelf = shelf };
+
+        // act
+        var details = BookDetails.From(book);
+
+        // assert nested shelf mapping
+        Assert.NotNull(details.Shelf);
+        Assert.Equal(shelf.Id, details.Shelf.Id);
+        Assert.Equal(shelf.Location, details.Shelf.Location);
+    }
+}

src/RoyalCode.SmartSelector.Generators/AnalyzerDiagnostics.cs

@@ -38,4 +38,19 @@ internal static class AnalyzerDiagnostics
         defaultSeverity: DiagnosticSeverity.Error,
         isEnabledByDefault: true);
 
+    public static readonly DiagnosticDescriptor ConflictingAutoPropertiesAttributes = new(
+        id: "RCSS004",
+        title: "Conflicting AutoProperties attributes",
+        messageFormat: "The class {0} cannot use both AutoPropertiesAttribute and AutoPropertiesAttribute<TFrom>",
+        category: Category,
+        defaultSeverity: DiagnosticSeverity.Error,
+        isEnabledByDefault: true);
+
+    public static readonly DiagnosticDescriptor InvalidAutoPropertiesTypeArgument = new(
+        id: "RCSS005",
+        title: "Invalid AutoProperties type argument",
+        messageFormat: "Invalid type argument '{0}' for AutoPropertiesAttribute<TFrom>; it must be a valid class or struct type",
+        category: Category,
+        defaultSeverity: DiagnosticSeverity.Error,
+        isEnabledByDefault: true);
 }