Atualização de versão e adição de métodos na classe Problems

* Atualização de versão
  - Alterado `SPPreview` de `-preview-4.6` para `-preview-4.7`.

* Melhoria na classe Problems
  - Adicionados métodos `ForEach(Action<Problem> action)` e `ForEach<T>(T param, Action<T, Problem> action)`.
  - Incluídas documentações XML para novos métodos, melhorando a legibilidade.

Author: eglauko

src/Directory.Build.props

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

src/RoyalCode.SmartProblems/Problems.cs

@@ -480,6 +480,64 @@ public InvalidOperationException ToException(string messagePattern, string separ
         return new InvalidOperationException(message);
     }
 
+    /// <summary>
+    /// Execute the specified action for each problem in the collection.
+    /// </summary>
+    /// <param name="action">The action to execute for each problem.</param>
+    /// <returns>
+    ///     The same instance of the collection, to allow method chaining.
+    /// </returns>
+    public Problems ForEach(Action<Problem> action)
+    {
+        ArgumentNullException.ThrowIfNull(action);
+        
+        if (Count == 0)
+            return this;
+
+        action(firstProblem!);
+
+        if (Count == 1)
+            return this;
+
+        var current = head;
+        while (current is not null)
+        {
+            action(current.Problem);
+            current = current.Next;
+        }
+
+        return this;
+    }
+
+    /// <summary>
+    /// Execute the specified action for each problem in the collection, passing an additional parameter.
+    /// </summary>
+    /// <typeparam name="T">The type of the additional parameter.</typeparam>
+    /// <param name="param">The additional parameter to pass to the action.</param>
+    /// <param name="action">The action to execute for each problem, with the additional parameter.</param>
+    /// <returns>The same instance of the collection, to allow method chaining.</returns>
+    public Problems ForEach<T>(T param, Action<T, Problem> action)
+    {
+        ArgumentNullException.ThrowIfNull(param);
+        ArgumentNullException.ThrowIfNull(action);
+
+        if (Count == 0)
+            return this;
+
+        action(param, firstProblem!);
+
+        if (Count == 1)
+            return this;
+
+        var current = head;
+        while (current is not null) {
+            action(param, current.Problem);
+            current = current.Next;
+        }
+
+        return this;
+    }
+
     /// <summary>
     /// Convert the collection of problems to a <see cref="Result"/> instance.
     /// </summary>