Main Cleanup

Author: mckaragoz

BCSS.Test/CoreTests/BunitTest.cs

@@ -1,13 +1,7 @@
-
-using System;
-using System.Threading.Tasks;
-using BCSS.Services;
+using BCSS.Services;
 using Bunit;
-using Microsoft.Extensions.DependencyInjection;
-using MudBlazor;
 using MudBlazor.Services;
 using MudExtensions.Services;
-using NUnit.Framework;
 
 namespace BCSS.Test.Core
 {

BCSS.Test/CoreTests/ConverterTests.cs

@@ -1,10 +1,5 @@
-using Bunit;
-using BCSSViewer.Docs.Pages;
-using FluentAssertions;
-using MudBlazor;
-using MudExtensions;
+using FluentAssertions;
 using BCSS.Services;
-using Microsoft.AspNetCore.Components;
 
 namespace BCSS.Test.Core
 {

BCSS.Test/CoreTests/RenderTests.cs

@@ -1,8 +1,5 @@
-using Bunit;
-using BCSSViewer.Docs.Pages;
+using BCSSViewer.Docs.Pages;
 using FluentAssertions;
-using MudBlazor;
-using MudExtensions;
 
 namespace BCSS.Test.Core
 {

BCSS/Component/BlazorCssProvider.razor

@@ -1,5 +1,5 @@
 @namespace BCSS
-@using BCSS.Services;
+@using BCSS.Services
 @inherits ComponentBase
 @inject BcssService BcssService
 

BCSS/Component/BlazorCssProvider.razor.cs

@@ -24,18 +24,33 @@ public partial class BlazorCssProvider : ComponentBase
         [Parameter]
         public bool KeepSingleValue { get; set; }
 
+        /// <summary>
+        /// The spacing multiplier for px measured CSS properties like padding, margin, top, left, right, bottom.
+        /// </summary>
         [Parameter]
         public int Spacing { get; set; } = 1;
 
+        /// <summary>
+        /// The small size measured by pixels.
+        /// </summary>
         [Parameter]
         public int Sm { get; set; } = 600;
 
+        /// <summary>
+        /// The medium size measured by pixels.
+        /// </summary>
         [Parameter]
         public int Md { get; set; } = 960;
 
+        /// <summary>
+        /// The large size measured by pixels.
+        /// </summary>
         [Parameter]
         public int Lg { get; set; } = 1280;
 
+        /// <summary>
+        /// The extra large size measured by pixels.
+        /// </summary>
         [Parameter]
         public int Xl { get; set; } = 1920;
 
@@ -126,6 +141,10 @@ protected internal async Task<bool> IsValid(string propName, string propValue, b
             return true;
         }
 
+        /// <summary>
+        /// Check all BCSS classes if they are valid or not. The method will automatically removes stored and invalid BCSS classes.
+        /// </summary>
+        /// <returns></returns>
         public async Task CheckAllValues()
         {
             List<BcssInfo> toBeDeletedInfos = new();
@@ -227,16 +246,23 @@ public void Update()
             _shouldRender = false;
         }
 
-        public void Clear(string key)
+        /// <summary>
+        /// Removes all BCSS classes (if key is null or empty) or matched classes (if key specified). If a BCSS class is currently using in the page, it will automatically add again.
+        /// </summary>
+        /// <param name="key"></param>
+        public void Clear(string? key = null)
         {
+            if (string.IsNullOrEmpty(key))
+            {
+                _bcssInfos.Clear();
+                return;
+            }
             _bcssInfos.RemoveAll(x => x.Key?.Split("-").First() == key.Split('-').First());
         }
 
-        public void Clear()
-        {
-            _bcssInfos.Clear();
-        }
-
+        /// <summary>
+        /// Removes last added BcssInfo.
+        /// </summary>
         public void ClearLast()
         {
             _bcssInfos.Remove(_bcssInfos.Last());

BCSS/Extensions/ServiceCollectionExtensions.cs

@@ -1,11 +1,8 @@
-using System;
-using System.Diagnostics.CodeAnalysis;
-using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.DependencyInjection.Extensions;
 
 namespace BCSS.Services
 {
-    [ExcludeFromCodeCoverage]
     public static class ServiceCollectionExtensions
     {
         public static IServiceCollection AddBcss(this IServiceCollection services)

BCSS/Services/BcssService.cs

@@ -114,6 +114,11 @@ public void Reset()
             Provider.Update();
         }
 
+        /// <summary>
+        /// Adds unified classes with given user-created name and BCSS classes seperated with space.
+        /// </summary>
+        /// <param name="unifiedName"></param>
+        /// <param name="value"></param>
         public void AddUnifiedClass(string unifiedName, string value)
         {
             if (Provider == null)
@@ -181,7 +186,7 @@ public void SetPerformanceMode(bool value)
 #pragma warning restore BL0005
         }
 
-        public async Task CheckValuesIsValid()
+        public async Task RemoveInvalidClasses()
         {
             if (Provider == null)
             {

BCSS/Services/BlazorCssConverter.cs

@@ -43,7 +43,7 @@ public static string Convert(string className, BlazorCssProvider? provider = nul
             }
 
             bool _shouldNotLowercase = false;
-            if (className.Contains("[") && className.Contains("/"))
+            if (className.Contains('[') && className.Contains('/'))
             {
                 _shouldNotLowercase = true;
             }
@@ -226,7 +226,7 @@ public static string Convert(string className, BlazorCssProvider? provider = nul
 
             if (string.Equals(fullKey, "bottom", StringComparison.InvariantCultureIgnoreCase))
             {
-                return DimensionResult(processedValue, fullKey);
+                return DimensionResult(processedValue.Replace('n', '-'), fullKey);
             }
 
             if (string.Equals(fullKey, "box", StringComparison.InvariantCultureIgnoreCase))
@@ -306,7 +306,7 @@ public static string Convert(string className, BlazorCssProvider? provider = nul
 
             if (string.Equals(fullKey, "left", StringComparison.InvariantCultureIgnoreCase))
             {
-                return DimensionResult(processedValue, fullKey);
+                return DimensionResult(processedValue.Replace('n', '-'), fullKey);
             }
 
             if (string.Equals(fullKey, "min-height", StringComparison.InvariantCultureIgnoreCase))
@@ -541,7 +541,7 @@ public static string Convert(string className, BlazorCssProvider? provider = nul
 
             if (string.Equals(fullKey, "right", StringComparison.InvariantCultureIgnoreCase))
             {
-                return DimensionResult(processedValue, fullKey);
+                return DimensionResult(processedValue.Replace('n', '-'), fullKey);
             }
 
             if (string.Equals(fullKey, "rotate", StringComparison.InvariantCultureIgnoreCase))
@@ -663,7 +663,7 @@ public static string Convert(string className, BlazorCssProvider? provider = nul
 
             if (string.Equals(fullKey, "top", StringComparison.InvariantCultureIgnoreCase))
             {
-                return DimensionResult(processedValue, fullKey);
+                return DimensionResult(processedValue.Replace('n', '-'), fullKey);
             }
 
             if (string.Equals(fullKey, "translate", StringComparison.InvariantCultureIgnoreCase))

BCSS/wwwroot/Bcss.js

@@ -1,5 +1,4 @@
-
-function checkcss(propname, propvalue) {
+function checkcss(propname, propvalue) {
     var result = CSS.supports(propname, propvalue);
     return result;
-}
+}

BCSSViewer/Pages/_Host.cshtml

@@ -48,6 +48,6 @@
     <script src="_framework/blazor.server.js"></script>
     <script src="_content/MudBlazor/MudBlazor.min.js"></script>
     <script src="_content/CodeBeam.MudBlazor.Extensions/MudExtensions.min.js"></script>
-    <script src="_content/CodeBeam.BCSS/Bcss.js"></script>
+    <script src="_content/CodeBeam.BCSS/Bcss.min.js"></script>
 </body>
 </html>