Move RuntimeTypeConverter out of pubternal namespace

Author: bkoelman

src/JsonApiDotNetCore.Annotations/Resources/Identifiable.cs

@@ -1,5 +1,4 @@
 using System.ComponentModel.DataAnnotations.Schema;
-using JsonApiDotNetCore.Resources.Internal;
 
 namespace JsonApiDotNetCore.Resources;
 

src/JsonApiDotNetCore.Annotations/Resources/Internal/RuntimeTypeConverter.cs renamed to src/JsonApiDotNetCore.Annotations/Resources/RuntimeTypeConverter.cs

@@ -3,13 +3,31 @@
 
 #pragma warning disable AV1008 // Class should not be static
 
-namespace JsonApiDotNetCore.Resources.Internal;
+namespace JsonApiDotNetCore.Resources;
 
+/// <summary>
+/// Provides utilities regarding runtime types.
+/// </summary>
 [PublicAPI]
 public static class RuntimeTypeConverter
 {
     private const string ParseQueryStringsUsingCurrentCultureSwitchName = "JsonApiDotNetCore.ParseQueryStringsUsingCurrentCulture";
 
+    /// <summary>
+    /// Converts the specified value to the specified type.
+    /// </summary>
+    /// <param name="value">
+    /// The value to convert from.
+    /// </param>
+    /// <param name="type">
+    /// The type to convert to.
+    /// </param>
+    /// <returns>
+    /// The converted type, or <c>null</c> if <paramref name="value" /> is <c>null</c> and <paramref name="type" /> is a nullable type.
+    /// </returns>
+    /// <exception cref="FormatException">
+    /// <paramref name="value" /> is not compatible with <paramref name="type" />.
+    /// </exception>
     public static object? ConvertType(object? value, Type type)
     {
         ArgumentGuard.NotNull(type);
@@ -114,11 +132,20 @@ public static class RuntimeTypeConverter
         }
     }
 
+    /// <summary>
+    /// Indicates whether the specified type is a nullable value type or a reference type.
+    /// </summary>
     public static bool CanContainNull(Type type)
     {
         return !type.IsValueType || Nullable.GetUnderlyingType(type) != null;
     }
 
+    /// <summary>
+    /// Gets the default value for the specified type.
+    /// </summary>
+    /// <returns>
+    /// The default value, or <c>null</c> for nullable value types and reference types.
+    /// </returns>
     public static object? GetDefaultValue(Type type)
     {
         return type.IsValueType ? Activator.CreateInstance(type) : null;

src/JsonApiDotNetCore/Queries/Parsing/FilterParser.cs

@@ -7,7 +7,6 @@
 using JsonApiDotNetCore.QueryStrings.FieldChains;
 using JsonApiDotNetCore.Resources;
 using JsonApiDotNetCore.Resources.Annotations;
-using JsonApiDotNetCore.Resources.Internal;
 
 namespace JsonApiDotNetCore.Queries.Parsing;
 

src/JsonApiDotNetCore/Queries/QueryableBuilding/WhereClauseBuilder.cs

@@ -4,8 +4,8 @@
 using JsonApiDotNetCore.Configuration;
 using JsonApiDotNetCore.Errors;
 using JsonApiDotNetCore.Queries.Expressions;
+using JsonApiDotNetCore.Resources;
 using JsonApiDotNetCore.Resources.Annotations;
-using JsonApiDotNetCore.Resources.Internal;
 
 namespace JsonApiDotNetCore.Queries.QueryableBuilding;
 

src/JsonApiDotNetCore/Resources/IdentifiableExtensions.cs

@@ -1,5 +1,4 @@
 using System.Reflection;
-using JsonApiDotNetCore.Resources.Internal;
 
 namespace JsonApiDotNetCore.Resources;
 

src/JsonApiDotNetCore/Serialization/Response/ResponseModelAdapter.cs

@@ -10,7 +10,6 @@
 using JsonApiDotNetCore.QueryStrings;
 using JsonApiDotNetCore.Resources;
 using JsonApiDotNetCore.Resources.Annotations;
-using JsonApiDotNetCore.Resources.Internal;
 using JsonApiDotNetCore.Serialization.Objects;
 
 namespace JsonApiDotNetCore.Serialization.Response;

test/JsonApiDotNetCoreTests/IntegrationTests/QueryStrings/CustomFunctions/TimeOffset/TimeOffsetFilterParser.cs

@@ -1,7 +1,6 @@
 using JsonApiDotNetCore.Queries.Expressions;
 using JsonApiDotNetCore.Queries.Parsing;
 using JsonApiDotNetCore.Resources;
-using JsonApiDotNetCore.Resources.Internal;
 
 namespace JsonApiDotNetCoreTests.IntegrationTests.QueryStrings.CustomFunctions.TimeOffset;
 

test/JsonApiDotNetCoreTests/UnitTests/TypeConversion/RuntimeTypeConverterTests.cs

@@ -1,5 +1,5 @@
 using FluentAssertions;
-using JsonApiDotNetCore.Resources.Internal;
+using JsonApiDotNetCore.Resources;
 using Xunit;
 
 namespace JsonApiDotNetCoreTests.UnitTests.TypeConversion;