Refactor TypeData to use direct Type property, add explicit impls

Refactor TypeData and related reflection utilities to use a direct Type property instead of UnwrapType(), improving clarity and performance. Add caching and accessors for explicit interface implementations (properties, methods, events) in TypeData. Improve explicit interface implementation detection in MethodData with a new mapping cache. Update documentation and clean up code for better maintainability and efficiency.

Author: BionicCode

src/BionicCode.Utilities.Net.Common/Exception/ArgumentExceptionHelpers.cs

@@ -326,7 +326,7 @@ internal static void ThrowIfEventHandlerNotAssignable([NotNull] Delegate clientH
 
         for (int parameterIndex = 0; parameterIndex < eventDelegateParameters.Count; parameterIndex++)
         {
-            Type eventDelegateParameterType = eventDelegateParameters[parameterIndex].ParameterTypeData.UnwrapType();
+            Type eventDelegateParameterType = eventDelegateParameters[parameterIndex].ParameterTypeData.Type;
             Type eventHandlerParameterType = clientHandlerParameters[parameterIndex].ParameterType;
             if (!eventHandlerParameterType.IsAssignableFrom(eventDelegateParameterType))
             {

src/BionicCode.Utilities.Net.Common/ProxyEventHandlerGenerator.cs

@@ -38,7 +38,7 @@ private static Delegate GenerateProxy(ParameterList eventHandlerParameters, Type
             var expressionParameters = new List<ParameterExpression>();
             foreach (ParameterData parameter in eventHandlerParameters)
             {
-                ParameterExpression expressionParameter = Expression.Parameter(parameter.ParameterTypeData.UnwrapType(), parameter.Name);
+                ParameterExpression expressionParameter = Expression.Parameter(parameter.ParameterTypeData.Type, parameter.Name);
                 expressionParameters.Add(expressionParameter);
             }
 
@@ -49,7 +49,7 @@ private static Delegate GenerateProxy(ParameterList eventHandlerParameters, Type
                 if (lastParameter.IsParams)
                 {
                     IEnumerable<Expression> paramsParameterArguments = expressionParameters.Skip(lastParameter.GetParameterInfo().Position)
-                                  .Select(parameter => Expression.TypeAs(parameter, lastParameter.ParameterTypeData.UnwrapType().GetElementType()))
+                                  .Select(parameter => Expression.TypeAs(parameter, lastParameter.ParameterTypeData.Type.GetElementType()))
                                   .Cast<Expression>();
                     NewArrayExpression argsArray = Expression.NewArrayInit(typeof(object), paramsParameterArguments);
                     delegateParameters.RemoveRange(lastParameter.Position, expressionParameters.Count - lastParameter.Position);
@@ -70,7 +70,7 @@ private static Delegate GenerateProxy(ParameterList eventHandlerParameters, Type
                 throw;
             }
 
-            Type eventDelegateType = eventDelegateTypeData.UnwrapType();
+            Type eventDelegateType = eventDelegateTypeData.Type;
             Delegate proxyEventSourceHandler = Expression.Lambda(eventDelegateType, method, expressionParameters).Compile();
 
             return proxyEventSourceHandler;

src/BionicCode.Utilities.Net.Profiling/AttributeProfiler.cs

@@ -620,7 +620,7 @@ private void GetTargetMethods(TypeData typeDataToProfile, bool isFindInstancePro
 
                 MethodInfo methodInfo = methodData.GetMethodInfo();
                 bool isMethodStatic = methodData.IsStatic;
-                bool isFactoryMethod = isMethodStatic && typeDataToProfile.UnwrapType().IsAssignableFrom(methodData.ReturnTypeData.UnwrapType());
+                bool isFactoryMethod = isMethodStatic && typeDataToProfile.Type.IsAssignableFrom(methodData.ReturnTypeData.Type);
                 if (isFindInstanceProviderEnabled
                   && !hasHighPriorityInstanceProvider
                   && isFactoryMethod)
@@ -754,7 +754,7 @@ private void GetTargetProperties(TypeData typeDataToProfile, bool isFindInstance
                   && !hasHighPriorityInstanceProvider
                   && isPropertyStatic
                   && propertyData.CanRead
-                  && typeDataToProfile.UnwrapType().IsAssignableFrom(propertyData.PropertyTypeData.UnwrapType()))
+                  && typeDataToProfile.Type.IsAssignableFrom(propertyData.PropertyTypeData.Type))
                 {
                     ProfilerFactoryAttribute profilerFactoryAttribute = propertyInfo.GetCustomAttribute<ProfilerFactoryAttribute>(false);
                     hasHighPriorityInstanceProvider = profilerFactoryAttribute != null;
@@ -823,7 +823,7 @@ private void GetInstanceProviderField(TypeData typeDataToProfile, CancellationTo
                 FieldInfo fieldInfo = fieldData.GetFieldInfo();
                 if (fieldData.IsStatic
                   && !hasHighPriorityInstanceProvider
-                  && typeDataToProfile.UnwrapType().IsAssignableFrom(fieldData.FieldTypeData.UnwrapType()))
+                  && typeDataToProfile.Type.IsAssignableFrom(fieldData.FieldTypeData.Type))
                 {
                     hasHighPriorityInstanceProvider = fieldInfo.GetCustomAttribute<ProfilerFactoryAttribute>(false) != null;
                     if (hasHighPriorityInstanceProvider || instanceProviderInfo is null)

src/BionicCode.Utilities.Reflection/ConstructorListBuilder.cs

@@ -58,7 +58,7 @@ internal static ConstructorList Create(IEnumerable<ConstructorInfo>? items)
         internal static ConstructorList Create(TypeData declaringTypeData)
         {
             ArgumentNullException.ThrowIfNull(declaringTypeData);
-            return CreateInternal(declaringTypeData.UnwrapType());
+            return CreateInternal(declaringTypeData.Type);
         }
 
         internal static ConstructorList Create(Type declaringType)