Add provider-neutral verification and provider discovery (#113)

* Add provider-neutral verification and discovery support

* Fix provider-neutral matcher verification follow-ups

* Finalize FastArg verification guidance

* Add provider discovery mode controls

Author: cwinland

Directory.Packages.props

@@ -47,10 +47,10 @@
 
   <ItemGroup Condition="'$(TargetFramework)' == 'net10.0'">
     <PackageVersion Include="Microsoft.Azure.Functions.Worker" Version="2.51.0" />
-    <PackageVersion Include="Microsoft.Extensions.Configuration" Version="10.*" />
-    <PackageVersion Include="Microsoft.Extensions.DependencyInjection" Version="10.*" />
-    <PackageVersion Include="Microsoft.Extensions.Logging" Version="10.*" />
-    <PackageVersion Include="Microsoft.Extensions.Options" Version="10.*" />
-    <PackageVersion Include="System.Configuration.ConfigurationManager" Version="10.*" />
+    <PackageVersion Include="Microsoft.Extensions.Configuration" Version="10.0.6" />
+    <PackageVersion Include="Microsoft.Extensions.DependencyInjection" Version="10.0.6" />
+    <PackageVersion Include="Microsoft.Extensions.Logging" Version="10.0.6" />
+    <PackageVersion Include="Microsoft.Extensions.Options" Version="10.0.6" />
+    <PackageVersion Include="System.Configuration.ConfigurationManager" Version="10.0.6" />
   </ItemGroup>
 </Project>

FastMoq.Abstractions/FastMoq.Abstractions.csproj

@@ -40,4 +40,5 @@
   <ItemGroup>
     <FrameworkReference Include="Microsoft.AspNetCore.App" />
   </ItemGroup>
+
 </Project>

FastMoq.Abstractions/Providers/FastArg.cs

@@ -0,0 +1,46 @@
+using System.Linq.Expressions;
+
+namespace FastMoq.Providers
+{
+    /// <summary>
+    /// Provider-neutral argument matcher helpers for FastMoq expression-based setup and verification flows.
+    /// </summary>
+    public static class FastArg
+    {
+        /// <summary>
+        /// Matches any argument of type <typeparamref name="T" />.
+        /// </summary>
+        /// <remarks>
+        /// Use this only inside FastMoq-supported expression-based setup or verification APIs.
+        /// </remarks>
+        public static T Any<T>() => default!;
+
+        /// <summary>
+        /// Matches any expression argument of type <c>Expression&lt;Func&lt;T, bool&gt;&gt;</c>.
+        /// </summary>
+        /// <remarks>
+        /// This is the provider-neutral replacement for older wildcard expression helpers such as <c>Mocker.BuildExpression&lt;T&gt;()</c> in new code.
+        /// </remarks>
+        public static Expression<Func<T, bool>> AnyExpression<T>() => _ => true;
+
+        /// <summary>
+        /// Matches an argument when the supplied predicate returns <see langword="true" />.
+        /// </summary>
+        /// <param name="predicate">The predicate used to evaluate the runtime argument.</param>
+        public static T Is<T>(Expression<Func<T, bool>> predicate)
+        {
+            ArgumentNullException.ThrowIfNull(predicate);
+            return default!;
+        }
+
+        /// <summary>
+        /// Matches a <see langword="null" /> argument.
+        /// </summary>
+        public static T IsNull<T>() => default!;
+
+        /// <summary>
+        /// Matches a non-<see langword="null" /> argument.
+        /// </summary>
+        public static T IsNotNull<T>() => default!;
+    }
+}