Atualização do SPPreview e melhorias na classe Problem

* Atualização de dependências
  - Atualizado o `SPPreview` para a versão `-preview-4.2`.

* Refatoração da classe Problem
  - Introduzido o campo privado `_property` para gerenciar `Property`.
  - Alterado `Property` para usar o novo campo, permitindo lógica personalizada.

* Novas funcionalidades na classe Problem
  - Adicionadas as funções `ChainProperty` e `ChainProperty` com índice para encadeamento de propriedades.

* Testes unitários
  - Adicionados testes para verificar o comportamento das novas funções de encadeamento.
  - Introduzido o enum `MyEnum` para uso nos testes, demonstrando extensões com valores de enum.

Author: eglauko

src/Directory.Build.props

@@ -10,7 +10,7 @@
 	</PropertyGroup>
 	<PropertyGroup>
 		<SPVer>1.0.0</SPVer>
-		<SPPreview>-preview-4.1</SPPreview>
+		<SPPreview>-preview-4.2</SPPreview>
 	</PropertyGroup>
 	<PropertyGroup>
 		<FluentValidationVer>12.0.0</FluentValidationVer>

src/RoyalCode.SmartProblems.Tests/Basics/ProblemTests.cs

@@ -0,0 +1,118 @@
+namespace RoyalCode.SmartProblems.Tests.Basics;
+
+public class ProblemTests
+{
+    [Fact]
+    public void Problem_ChainProperty_MustConcatProperties()
+    {
+        // Arrange
+        var problem = Problems.InvalidParameter("Invalid parameter", "my-property");
+
+        // Act
+        problem.ChainProperty("my-other-property");
+
+        // Assert
+        Assert.Equal("my-other-property.my-property", problem.Property);
+    }
+
+    [Fact]
+    public void Problem_ChainProperty_WithNullProperty_MustDoNothing()
+    {
+        // Arrange
+        var problem = Problems.InvalidParameter("Invalid parameter");
+
+        // Act
+        problem.ChainProperty("my-property");
+
+        // Assert
+        Assert.Null(problem.Property);
+    }
+
+    [Fact]
+    public void Problem_ChainProperty_WithEmptyProperty_MustDoNothing()
+    {
+        // Arrange
+        var problem = Problems.InvalidParameter("Invalid parameter", string.Empty);
+
+        // Act
+        problem.ChainProperty("my-property");
+
+        // Assert
+        Assert.Equal(string.Empty, problem.Property);
+    }
+
+    [Fact]
+    public void Problem_ChainProperty_WithIndex_MustConcatProperties()
+    {
+        // Arrange
+        var problem = Problems.InvalidParameter("Invalid parameter", "my-property");
+
+        // Act
+        problem.ChainProperty("my-other-property", 1);
+
+        // Assert
+        Assert.Equal("my-other-property[1].my-property", problem.Property);
+    }
+
+    [Fact]
+    public void Problem_ChainProperty_WithIndexAndNullProperty_MustDoNothing()
+    {
+        // Arrange
+        var problem = Problems.InvalidParameter("Invalid parameter");
+
+        // Act
+        problem.ChainProperty("my-property", 1);
+
+        // Assert
+        Assert.Null(problem.Property);
+    }
+
+    [Fact]
+    public void Problem_ChainProperty_WithIndexAndEmptyProperty_MustDoNothing()
+    {
+        // Arrange
+        var problem = Problems.InvalidParameter("Invalid parameter", string.Empty);
+
+        // Act
+        problem.ChainProperty("my-property", 1);
+
+        // Assert
+        Assert.Equal(string.Empty, problem.Property);
+    }
+
+    [Fact]
+    public void Problem_With_MustAddExtension()
+    {
+        // Arrange
+        var problem = Problems.InvalidParameter("Invalid parameter");
+
+        // Act
+        problem.With("my-key", "my-value");
+
+        // Assert
+        Assert.NotNull(problem.Extensions);
+        Assert.Single(problem.Extensions);
+        Assert.Equal("my-value", problem.Extensions["my-key"]);
+    }
+
+    [Fact]
+    public void Problem_WithEnum_MustAddExtension()
+    {
+        // Arrange
+        var problem = Problems.InvalidParameter("Invalid parameter");
+
+        // Act
+        problem.With("my-key", MyEnum.Value1);
+
+        // Assert
+        Assert.NotNull(problem.Extensions);
+        Assert.Single(problem.Extensions);
+        Assert.Equal("Value1", problem.Extensions["my-key"]);
+    }
+}
+
+file enum MyEnum
+{
+    Value1,
+    Value2
+}

src/RoyalCode.SmartProblems/Problem.cs

@@ -36,6 +36,8 @@ public sealed class Problem
 
     #endregion
 
+    private string? _property;
+
     /// <summary>
     /// <para>
     ///     Description of the problem, like a message to the user.
@@ -60,7 +62,7 @@ public sealed class Problem
     /// <summary>
     /// Optional, the property that the problem is related to.
     /// </summary>
-    public string? Property { get; init; }
+    public string? Property { get => _property; init => _property = value; }
 
     /// <summary>
     /// Optional, extra information about the problem.
@@ -96,6 +98,35 @@ public Problem With<TEnum>(string key, TEnum value)
         return With(key, value.ToString());
     }
 
+    /// <summary>
+    /// Encadeia uma propriedade ao início da propriedade atual, formando uma propriedade aninhada (ex: Endereco.Rua).
+    /// </summary>
+    /// <param name="parentProperty">Nome da propriedade a ser encadeada.</param>
+    /// <returns>Esta instância de Problem com a propriedade modificada.</returns>
+    public Problem ChainProperty(string parentProperty)
+    {
+        if (string.IsNullOrEmpty(parentProperty) || string.IsNullOrEmpty(_property))
+            return this;
+
+        _property = $"{parentProperty}.{Property}";
+        return this;
+    }
+
+    /// <summary>
+    /// Encadeia uma propriedade de coleção com índice ao início da propriedade atual (ex: Endereco[0].Rua).
+    /// </summary>
+    /// <param name="parentProperty">Nome da propriedade de coleção.</param>
+    /// <param name="index">Índice da coleção.</param>
+    /// <returns>Esta instância de Problem com a propriedade modificada.</returns>
+    public Problem ChainProperty(string parentProperty, int index)
+    {
+        if (string.IsNullOrEmpty(parentProperty) || string.IsNullOrEmpty(_property))
+            return this;
+
+        _property = $"{parentProperty}[{index}].{Property}";
+        return this;
+    }
+
     /// <inheritdoc />
     public override string ToString() => ToStringFactory(this);