feat(Core): add BootstrapBlazor.Core project (#4205)

* chore: 增加 Core 工程

* chore: bump version 8.9.1-beta01

* chore: 更新 readme 文件

* test: 增加单元测试

* test: 更新单元测试

* test: 更新单元测试

Author: ArgoZhang

BootstrapBlazor.sln

@@ -162,6 +162,8 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "BootstrapBlazor.WinBox", "s
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "BootstrapBlazor.Player", "src\Extensions\Components\BootstrapBlazor.Player\BootstrapBlazor.Player.csproj", "{C6145F86-D8F0-42A6-AE06-0EABA90ECD6B}"
 EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "BootstrapBlazor.Core", "src\BootstrapBlazor.Core\BootstrapBlazor.Core.csproj", "{6162D045-845C-4753-9A4D-52090D9390D5}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -382,6 +384,10 @@ Global
 		{C6145F86-D8F0-42A6-AE06-0EABA90ECD6B}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{C6145F86-D8F0-42A6-AE06-0EABA90ECD6B}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{C6145F86-D8F0-42A6-AE06-0EABA90ECD6B}.Release|Any CPU.Build.0 = Release|Any CPU
+		{6162D045-845C-4753-9A4D-52090D9390D5}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{6162D045-845C-4753-9A4D-52090D9390D5}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{6162D045-845C-4753-9A4D-52090D9390D5}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{6162D045-845C-4753-9A4D-52090D9390D5}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
@@ -448,6 +454,7 @@ Global
 		{50F286FD-D814-46C3-A70C-C2F789C4338C} = {CD062AB6-244D-402A-8F33-C37DAC5856CC}
 		{C19A57F2-DBE3-4CD4-96EA-337C93A4D886} = {CD062AB6-244D-402A-8F33-C37DAC5856CC}
 		{C6145F86-D8F0-42A6-AE06-0EABA90ECD6B} = {CD062AB6-244D-402A-8F33-C37DAC5856CC}
+		{6162D045-845C-4753-9A4D-52090D9390D5} = {A2182155-43ED-44C1-BF6F-1B70EBD2DFFE}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {0DCB0756-34FA-4FD0-AE1D-D3F08B5B3A6B}

src/BootstrapBlazor.Core/BootstrapBlazor.Core.csproj

@@ -0,0 +1,11 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <Version>8.0.0</Version>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <Using Include="BootstrapBlazor.Components" />
+  </ItemGroup>
+
+</Project>

src/BootstrapBlazor.Core/Converter/JsonDescriptionEnumConverter.cs

@@ -0,0 +1,48 @@
+// Copyright (c) Argo Zhang ([email protected]). All rights reserved.
+// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
+// Website: https://www.blazor.zone or https://argozhang.github.io/
+
+using System.Text.Json;
+using System.Text.Json.Serialization;
+
+namespace BootstrapBlazor.Core.Converter;
+
+/// <summary>
+/// 枚举类型转换器
+/// </summary>
+/// <remarks>序列化时把枚举类型序列化成字符串</remarks>
+public class JsonDescriptionEnumConverter<T> : JsonConverter<T> where T : struct, Enum
+{
+    /// <summary>
+    /// <inheritdoc/>
+    /// </summary>
+    /// <param name="reader"></param>
+    /// <param name="typeToConvert"></param>
+    /// <param name="options"></param>
+    /// <returns></returns>
+    public override T Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
+    {
+        T ret = default;
+        if (reader.TokenType == JsonTokenType.String)
+        {
+            var enumStringValue = reader.GetString();
+            var v = Enum.GetNames<T>().FirstOrDefault(i => typeof(T).ToDescriptionString(i) == enumStringValue);
+            if (Enum.TryParse<T>(v, true, out T val))
+            {
+                ret = val;
+            }
+        }
+        return ret;
+    }
+
+    /// <summary>
+    /// <inheritdoc/>
+    /// </summary>
+    /// <param name="writer"></param>
+    /// <param name="value"></param>
+    /// <param name="options"></param>
+    public override void Write(Utf8JsonWriter writer, T value, JsonSerializerOptions options)
+    {
+        writer.WriteStringValue(value.ToDescriptionString());
+    }
+}

src/BootstrapBlazor.Core/Directory.Build.props

@@ -0,0 +1,23 @@
+<Project>
+
+  <Import Project="..\Directory.Build.props" />
+  <Import Project="..\Frameworks.props" />
+  <Import Project="..\Logo.props" />
+  <Import Project="..\SourceLink.targets" />
+
+  <PropertyGroup>
+    <PackageTags>Bootstrap Blazor WebAssembly wasm UI Components</PackageTags>
+    <Description>Bootstrap UI components for Blazor and Razor Components</Description>
+    <PackageReadmeFile>readme.md</PackageReadmeFile>
+    <PackageReleaseNotes>https://github.com/dotnetcore/BootstrapBlazor/releases?wt.mc_id=DT-MVP-5004174</PackageReleaseNotes>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <None Include="readme.md" Pack="true" PackagePath="" />
+  </ItemGroup>
+
+  <PropertyGroup>
+    <NoWarn>NU1902;NU1903;CS8002</NoWarn>
+  </PropertyGroup>
+
+</Project>

src/BootstrapBlazor.Core/Extensions/EnumExtensions.cs

@@ -0,0 +1,39 @@
+// Copyright (c) Argo Zhang ([email protected]). All rights reserved.
+// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
+// Website: https://www.blazor.zone or https://argozhang.github.io/
+
+using System.ComponentModel;
+using System.Reflection;
+
+namespace BootstrapBlazor.Components;
+
+/// <summary>
+/// 枚举类型扩展方法
+/// </summary>
+public static class EnumExtensions
+{
+    /// <summary>
+    /// 获取 DescriptionAttribute 标签方法
+    /// </summary>
+    /// <param name="val"></param>
+    /// <returns></returns>
+    public static string ToDescriptionString<TEnum>(this TEnum val) where TEnum : Enum => typeof(TEnum).ToDescriptionString(val.ToString());
+
+    /// <summary>
+    /// 通过字段名称获取 DescriptionAttribute 标签值
+    /// </summary>
+    /// <param name="type"></param>
+    /// <param name="fieldName"></param>
+    /// <returns></returns>
+    public static string ToDescriptionString(this Type? type, string? fieldName)
+    {
+        var ret = string.Empty;
+        if (type != null && !string.IsNullOrEmpty(fieldName))
+        {
+            var t = Nullable.GetUnderlyingType(type) ?? type;
+            var attributes = t.GetField(fieldName)?.GetCustomAttribute<DescriptionAttribute>(true);
+            ret = attributes?.Description ?? fieldName;
+        }
+        return ret;
+    }
+}

src/Extensions/Components/BootstrapBlazor.Core/logo.png renamed to src/BootstrapBlazor.Core/logo.png

@@ -0,0 +1,4 @@
+# Bootstrap Blazor Core Library
+
+## Features
+- Provides a series of extension methods

src/BootstrapBlazor.Core/readme.md

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk.Razor">
 
   <PropertyGroup>
-    <Version>8.9.0</Version>
+    <Version>8.9.1-beta01</Version>
   </PropertyGroup>
 
   <ItemGroup Condition="'$(TargetFramework)' == 'net5.0'">
@@ -63,6 +63,10 @@
     <None Include="wwwroot\src\**\*.*" />
   </ItemGroup>
 
+  <ItemGroup>
+    <ProjectReference Include="..\BootstrapBlazor.Core\BootstrapBlazor.Core.csproj" />
+  </ItemGroup>
+
   <ItemGroup>
     <Using Include="BootstrapBlazor.Components" />
     <Using Include="Microsoft.AspNetCore.Components" />

src/BootstrapBlazor/BootstrapBlazor.csproj

@@ -12,31 +12,6 @@ namespace BootstrapBlazor.Components;
 /// </summary>
 public static class EnumExtensions
 {
-    /// <summary>
-    /// 获取 DescriptionAttribute 标签方法
-    /// </summary>
-    /// <param name="val"></param>
-    /// <returns></returns>
-    public static string ToDescriptionString<TEnum>(this TEnum val) where TEnum : Enum => typeof(TEnum).ToDescriptionString(val.ToString());
-
-    /// <summary>
-    /// 通过字段名称获取 DescriptionAttribute 标签值
-    /// </summary>
-    /// <param name="type"></param>
-    /// <param name="fieldName"></param>
-    /// <returns></returns>
-    public static string ToDescriptionString(this Type? type, string? fieldName)
-    {
-        var ret = string.Empty;
-        if (type != null && !string.IsNullOrEmpty(fieldName))
-        {
-            var t = Nullable.GetUnderlyingType(type) ?? type;
-            var attributes = t.GetField(fieldName)?.GetCustomAttribute<DescriptionAttribute>(true);
-            ret = attributes?.Description ?? fieldName;
-        }
-        return ret;
-    }
-
     /// <summary>
     /// 通过字段名称获取 DisplayAttribute/DescriptionAttribute 标签值
     /// </summary>