feat: emit matcher usage and update matcher specs

- add matcher usage attributes on generated overloads and stubs for matched/no-overload namespaces
- add MOG011 diagnostic handling plus matcher-usage attribute source emission
- convert matcher definitions in acceptance criteria/docs to interfaces and update related expectations
- allow OverloadGenerationOptionsAttribute on class/struct/interface and load acceptance criteria from subfolders

Author: teneko

README.md

@@ -60,10 +60,10 @@ public sealed class Customer
     public void Update(string param_1, int param_2) { }
 }
 
-internal static class CustomerMatcher
+internal interface CustomerMatcher
 {
     [GenerateOverloads(nameof(param_2))]
-    internal static extern void Update(string param_1, int param_2);
+    void Update(string param_1, int param_2);
 }
 ```
 
@@ -92,10 +92,10 @@ public static class MathUtils
     public static void Multiply(int param_1, int param_2) { }
 }
 
-internal static class MathMatchers
+internal interface MathMatchers
 {
     [GenerateOverloads(nameof(param_2))]
-    internal static extern void Multiply(int param_1, int param_2);
+    void Multiply(int param_1, int param_2);
 }
 ```
 

ref/Tenekon.MethodOverloads.AcceptanceCriterias/.editorconfig

@@ -2,6 +2,7 @@
 resharper_inconsistent_naming_highlighting=none
 resharper_prefer_concrete_value_over_default_highlighting=none
 resharper_partial_type_with_single_part_highlighting=none
+resharper_check_namespace_highlighting=none
 
 [*generated.cs]
 generated_code = true

ref/Tenekon.MethodOverloads.AcceptanceCriterias/Class_1.cs

@@ -1,3 +1,4 @@
+using System.Diagnostics.CodeAnalysis;
 using Tenekon.MethodOverloads.SourceGenerator;
 
 namespace Tenekon.MethodOverloads.AcceptanceCriterias;
@@ -28,9 +29,6 @@ public abstract class Class_1
 
     [GenerateOverloads(nameof(cancellationToken))]
     public abstract void Case_7(CancellationToken cancellationToken);
-
-    [GenerateOverloads]
-    public abstract void Case_8();
 }
 
 /// <summary>
@@ -73,4 +71,3 @@ public static class Class_1_AcceptanceCriterias
     public static void Case_7(this Class_1 source) => source.Case_7(cancellationToken: default);
 }
 
-

ref/Tenekon.MethodOverloads.AcceptanceCriterias/Class_16.cs

@@ -3,10 +3,10 @@
 
 namespace Tenekon.MethodOverloads.AcceptanceCriterias;
 
-internal class Class_16_Matcher
+internal interface Class_16_Matcher
 {
     [GenerateOverloads(nameof(param_2))]
-    internal static extern void Matcher_1(int param_1, string? param_2);
+    void Matcher_1(int param_1, string? param_2);
 }
 
 /// <summary>

ref/Tenekon.MethodOverloads.AcceptanceCriterias/Class_18.cs

@@ -4,13 +4,13 @@
 namespace Tenekon.MethodOverloads.AcceptanceCriterias;
 
 [OverloadGenerationOptions(RangeAnchorMatchMode = RangeAnchorMatchMode.TypeAndName)]
-internal class Class_18_Matcher
+internal interface Class_18_Matcher
 {
     [GenerateOverloads(nameof(param_2))]
-    internal static extern void Matcher_1(int param_1, string? param_2);
+    void Matcher_1(int param_1, string? param_2);
 
     [GenerateOverloads(nameof(param_2))]
-    internal static extern void Matcher_2(int param_1, string? param_2);
+    void Matcher_2(int param_1, string? param_2);
 }
 
 /// <summary>

ref/Tenekon.MethodOverloads.AcceptanceCriterias/Class_19.cs

@@ -2,10 +2,10 @@
 
 namespace Tenekon.MethodOverloads.AcceptanceCriterias;
 
-internal class Class_19_Matcher
+internal interface Class_19_Matcher
 {
     [GenerateOverloads(nameof(param_2))]
-    internal static extern void Matcher_1(int param_1, string? param_2);
+    void Matcher_1(int param_1, string? param_2);
 }
 
 /// <summary>

ref/Tenekon.MethodOverloads.AcceptanceCriterias/Class_20.cs

@@ -3,10 +3,10 @@
 
 namespace Tenekon.MethodOverloads.AcceptanceCriterias;
 
-internal class Class_20_Matcher
+internal interface Class_20_Matcher
 {
     [GenerateOverloads(nameof(param_2))]
-    internal static extern void Matcher_1(int param_1, string? param_2);
+    void Matcher_1(int param_1, string? param_2);
 }
 
 /// <summary>

ref/Tenekon.MethodOverloads.AcceptanceCriterias/Class_21.cs

@@ -34,13 +34,17 @@ public static void RefOmitted(int required, ref int refValue) { }
     public static void Duplicate(int value, string optional) { }
 
     public static void Duplicate(int value) { }
+
+    [GenerateOverloads]
+    [SuppressMessage("MethodOverloadsGenerator", "MOG011")]
+    public static void Parameterless() { }
 }
 
-internal static class Class_21_Matcher
+internal interface Class_21_Matcher
 {
     [SuppressMessage("MethodOverloadsGenerator", "MOG002")]
     [GenerateOverloads(nameof(m))]
-    internal static void MatcherSignature(int m) { }
+    void MatcherSignature(int m);
 }
 
 [GenerateMethodOverloads(Matchers = [typeof(Class_21_Matcher)])]

ref/Tenekon.MethodOverloads.AcceptanceCriterias/Class_23.cs

@@ -2,10 +2,10 @@
 
 namespace Tenekon.MethodOverloads.AcceptanceCriterias;
 
-internal static class Class_23_Matcher
+internal interface Class_23_Matcher
 {
     [GenerateOverloads(nameof(param_2))]
-    internal static extern void Matcher_1(int param_1, string? param_2);
+    void Matcher_1(int param_1, string? param_2);
 }
 
 /// <summary>

ref/Tenekon.MethodOverloads.AcceptanceCriterias/Class_24.cs

@@ -2,10 +2,10 @@
 
 namespace Tenekon.MethodOverloads.AcceptanceCriterias;
 
-internal static class Class_24_Matcher
+internal interface Class_24_Matcher
 {
     [GenerateOverloads(nameof(param_2))]
-    internal static extern void Matcher_1(int param_1, string? param_2);
+    void Matcher_1(int param_1, string? param_2);
 }
 
 /// <summary>
@@ -29,7 +29,6 @@ public interface Class_24_InterfaceTarget
     void Case_1(int param_1, string? param_2);
 }
 
-[System.Diagnostics.CodeAnalysis.SuppressMessage("ReSharper", "PreferConcreteValueOverDefault")]
 public static class Class_24_AcceptanceCriterias
 {
     public static void Case_1(this Class_24_ClassTarget source, int param_1) =>