Docs, multi-TFM, and codegen: .NET 9/10, docs PT-BR, samples

Documentation, multi-targeting, and codegen improvements

- Documentation and Language Consistency
  -- Updated README.md and docs.md to correct Portuguese, removing mojibake/encoding issues.
  -- Improved formatting, expanded quickstart, and added more minimal and advanced attribute usage examples.
  -- Clarified and expanded documentation for features, usage, and limitations.
  -- Added XML docs for attributes (AutoDetailsAttribute, AutoPropertiesAttribute, etc.) in RoyalCode.SmartSelector.xml.
  -- Added copilot-instructions.md with project and code style guidelines.

- Multi-Targeting and Dependency Management
  -- Added .NET 9 and .NET 10 support to the runtime library.
  -- Set test projects to use .NET 10.
  -- Updated package versions (Mapster, AutoMapper, BenchmarkDotNet, EF Core).
  -- Centralized and clarified dependency versioning (AspVer, ExtSrcGenVer, etc.) in build files.

- Code Generation and Formatting
  -- Fixed code formatting in SelectLambdaGenerator.cs (replaced .Ident with .Indent for clarity).
  -- Improved generated code readability and consistency.

- Solution and Packaging
  -- Ensured README is included and referenced in solution and packaging files.

- General Usability
  -- Improved clarity and usability for new users and maintainers, especially regarding supported frameworks, attribute usage, and generated code expectations.

Author: eglauko

README.md

@@ -1,39 +1,73 @@
 # SmartSelector
 
-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.
+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.
+- `[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
+## Quickstart
+
+1) 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
+2) Anote seu DTO
+```csharp
+[AutoSelect<User>, AutoProperties]
+public partial class UserDetails { }
+```
+
+3) Consulte com EF Core
+```csharp
+var list = db.Users.SelectUserDetails().ToList();
+var dto  = UserDetails.From(user);
+var expr = UserDetails.SelectUserExpression; // reutilizável / componível
+```
+
+Escopo e foco
+- Sem custom resolvers, conditional mapping ou naming policies.
+- Foco: projeções traduzíveis por EF Core e mapeamento 1x1 (estilo Adapt do Mapster).
+
+Links úteis
+- Documentação completa: `src/docs.md`
+- Projeto Demo: `RoyalCode.SmartSelector.Demo`
+- Benchmarks: `RoyalCode.SmartSelector.Benchmarks`
+
+Frameworks e pacotes suportados
+- Runtime lib: `RoyalCode.SmartSelector` (TFMs: .NET 8, .NET 9, .NET 10)
+- Generator: `RoyalCode.SmartSelector.Generators` (TFM: .NET Standard 2.0, instalado como Analyzer)
+
+## 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
+var expr = UserDetails.SelectUserExpression; // reutilizável / componível
 ```
-Código gerado (essencial):
+Código gerado (essencial):
 ```csharp
-public static Expression<Func<User, UserDetails>> SelectUserExpression => u => new UserDetails { Id = u.Id, Name = u.Name };
+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
+## Exemplo 2 – Objeto Aninhado + Exclusão
 ```csharp
 [AutoSelect<Book>, AutoProperties(Exclude = [ nameof(Book.Sku) ])]
 public partial class BookDetails
@@ -46,66 +80,132 @@ public partial class ShelfDetails { }
 ```
 Trecho gerado:
 ```csharp
-Shelf = new ShelfDetails { Id = a.Shelf.Id, Location = a.Shelf.Location },
-Price = a.Price,
-// Sku excluído
+new BookDetails
+{
+    Shelf = new ShelfDetails
+    {
+        Id = a.Shelf.Id,
+        Location = a.Shelf.Location
+    },
+    Price = a.Price,
+};
+// Sku excluído
 ```
 
-## Exemplo 3 – Flattening Profundo
+## Exemplo 3 – Flattening Profundo
 ```csharp
-public class Order { public Customer Customer { get; set; } }
+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:
+Trecho da expressão:
 ```csharp
 CustomerAddressCountryRegionName = a.Customer.Address.Country.Region.Name
 ```
 
+## Exemplos mínimos por atributo
+
+- `AutoSelect<T>`:
+
+```csharp
+[AutoSelect<Product>]
+public partial class ProductDetails { }
+
+// Uso:
+db.Products.SelectProductDetails().ToList();
+```
+
+- `AutoProperties`:
+
+```csharp
+[AutoSelect<Simple>, AutoProperties]
+public partial class SimpleDto { /* propriedades simples geradas automaticamente */ }
+```
+
+Para usar `AutoProperties`, o tipo de origem é inferido do `AutoSelect<TFrom>`.
+
+- `AutoProperties<TFrom>`:
+
+```csharp
+[AutoProperties<User>]
+public partial class UserSnapshot { }
+```
+
+- DTO aninhado + `Exclude`:
+
+```csharp
+[AutoSelect<Order>, AutoProperties<Order>(Exclude = [ nameof(Order.InternalCode) ])]
+public partial class OrderDetails 
+{
+    public CustomerDetails Customer { get; set; }
+}
+
+[AutoProperties<Customer>]
+public partial class CustomerDetails { }
+```
+
+- Flattening por nome:
+```csharp
+[AutoSelect<Order>]
+public partial class OrderFlat 
+{ 
+    public string CustomerAddressCity { get; set; }
+}
+
+// Gera: CustomerAddressCity = a.Customer.Address.City
+```
+
 ## Regras de Flattening
-- Nome da propriedade = concatenação PascalCase dos segmentos do caminho.
+- 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
+- Primitivos numéricos, `bool`, `string`, `char`, `DateTime` / nullable simples
 - `enum`, `struct`
-- `IEnumerable<T>` onde `T` é suportado acima / enum / struct
+- `IEnumerable<T>` onde `T` é suportado acima / enum / struct
 
-## Exclusões
+## 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`).
+## 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.
+## 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
+## Boas Práticas
 - Use `nameof` em `Exclude`.
-- Prefira consumir a expressão gerada para reutilização e composição LINQ.
+- 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
+## 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.
+| 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.
+- Projeto Demo: ver `RoyalCode.SmartSelector.Demo`.
+- Benchmarks: ver `RoyalCode.SmartSelector.Benchmarks`.
 
 ---
 Happy coding!

src/.github/copilot-instructions.md

@@ -0,0 +1,15 @@
+# Copilot Instructions
+
+## General Guidelines
+- First general instruction
+- Second general instruction
+
+## Code Style
+- Use specific formatting rules
+- Follow naming conventions
+
+## Project-Specific Rules
+- Projeto SmartSelector: foco em gerar modelos de leitura e expressões EF Core (Select) via atributos; sem planos para custom resolvers, conditional mapping ou naming policies.
+- Customizações são raras; mapeamento 1x1 estilo Mapster Adapt.
+- Versões centralizadas em Directory.Build.props/libs.targets/tests.targets.
+- Documentação principal no README.md.

src/Directory.Build.props

@@ -1,15 +1,14 @@
 <Project>
 	<PropertyGroup>
-		<LibFrwkVer>net8.0</LibFrwkVer>
-		<TestFrwkVer>net8.0</TestFrwkVer>
+		<LibFrwkVer>net8.0;net9.0;net10.0</LibFrwkVer>
+		<TestFrwkVer>net10.0</TestFrwkVer>
 		<GenFrwkVer>netstandard2.0</GenFrwkVer>
 	</PropertyGroup>
 	<PropertyGroup>
-		<DotNetCoreVersion>8.0.20</DotNetCoreVersion>
-		<ExtSrcGenVer>0.1.10</ExtSrcGenVer>
+		<ExtSrcGenVer>0.1.12</ExtSrcGenVer>
 	</PropertyGroup>
 	<PropertyGroup>
-		<Ver>0.3.0</Ver>
+		<Ver>0.4.0</Ver>
 		<Prev></Prev>
 	</PropertyGroup>
 </Project>