Core components added/updated.

Author: gvreddy04

BlazorExpress.Core/BlazorExpress.Core.csproj

@@ -2,8 +2,8 @@
 
   <PropertyGroup>
     <PackageId>BlazorExpress.Core</PackageId>
-    <Version>0.0.1</Version>
-    <PackageVersion>0.0.1</PackageVersion>
+    <Version>0.0.4</Version>
+    <PackageVersion>0.0.4</PackageVersion>
 
     <!--<PackageIconUrl></PackageIconUrl>-->
     <PackageLicenseExpression>Apache-2.0</PackageLicenseExpression>

BlazorExpress.Core/Components/BlazorExpressComponentCore.cs

@@ -8,7 +8,7 @@ public abstract class BlazorExpressComponentCore : ComponentBase, IDisposable, I
 
     private bool isDisposed;
 
-    internal Queue<Func<Task>> queuedTasks = new();
+    protected Queue<Func<Task>> queuedTasks = new();
 
     #endregion
 

BlazorExpress.Core/Components/BlazorExpressLayoutComponentCore.cs

@@ -0,0 +1,201 @@
+namespace BlazorExpress.Core;
+
+public abstract class BlazorExpressLayoutComponentCore : LayoutComponentBase, IDisposable, IAsyncDisposable
+{
+    #region Fields and Constants
+
+    private bool isAsyncDisposed;
+
+    private bool isDisposed;
+
+    protected Queue<Func<Task>> queuedTasks = new();
+
+    #endregion
+
+    #region Methods
+
+    /// <inheritdoc />
+    protected override async Task OnAfterRenderAsync(bool firstRender)
+    {
+        // process queued tasks
+        while (queuedTasks.TryDequeue(out var taskToExecute))
+            await taskToExecute.Invoke();
+
+        if (firstRender)
+            IsFirstRenderComplete = true;
+    }
+
+    /// <inheritdoc />
+    protected override void OnInitialized()
+    {
+        Id ??= IdUtility.GetNextId();
+    }
+
+    public static string BuildClassNames(params (string? cssClass, bool when)[] cssClassList)
+    {
+        var list = new HashSet<string>();
+
+        if (cssClassList is not null && cssClassList.Any())
+            foreach (var (cssClass, when) in cssClassList)
+                if (!string.IsNullOrWhiteSpace(cssClass) && when)
+                    list.Add(cssClass);
+
+        if (list.Any())
+            return string.Join(" ", list);
+
+        return string.Empty;
+    }
+
+    public static string BuildClassNames(string? userDefinedCssClass, params (string? cssClass, bool when)[] cssClassList)
+    {
+        var list = new HashSet<string>();
+
+        if (cssClassList is not null && cssClassList.Any())
+            foreach (var (cssClass, when) in cssClassList)
+                if (!string.IsNullOrWhiteSpace(cssClass) && when)
+                    list.Add(cssClass);
+
+        if (!string.IsNullOrWhiteSpace(userDefinedCssClass))
+            list.Add(userDefinedCssClass.Trim());
+
+        if (list.Any())
+            return string.Join(" ", list);
+
+        return string.Empty;
+    }
+
+    public static string BuildStyleNames(string? userDefinedCssStyle, params (string? cssStyle, bool when)[] cssStyleList)
+    {
+        var list = new HashSet<string>();
+
+        if (cssStyleList is not null && cssStyleList.Any())
+            foreach (var (cssStyle, when) in cssStyleList)
+                if (!string.IsNullOrWhiteSpace(cssStyle) && when)
+                    list.Add(cssStyle);
+
+        if (!string.IsNullOrWhiteSpace(userDefinedCssStyle))
+            list.Add(userDefinedCssStyle.Trim());
+
+        if (list.Any())
+            return string.Join(';', list);
+
+        return string.Empty;
+    }
+
+    /// <inheritdoc />
+    /// <seealso cref="https://learn.microsoft.com/en-us/dotnet/api/system.idisposable?view=net-6.0" />
+    public void Dispose()
+    {
+        Dispose(true);
+        GC.SuppressFinalize(this);
+    }
+
+    /// <inheritdoc />
+    /// <seealso
+    ///     cref="https://learn.microsoft.com/en-us/dotnet/standard/garbage-collection/implementing-disposeasync#implement-both-dispose-and-async-dispose-patterns" />
+    public async ValueTask DisposeAsync()
+    {
+        await DisposeAsyncCore(true).ConfigureAwait(false);
+
+        Dispose(false);
+        GC.SuppressFinalize(this);
+    }
+
+    protected virtual void Dispose(bool disposing)
+    {
+        if (!isDisposed)
+        {
+            if (disposing)
+            {
+                // cleanup
+            }
+
+            isDisposed = true;
+        }
+    }
+
+    protected virtual ValueTask DisposeAsyncCore(bool disposing)
+    {
+        if (!isAsyncDisposed)
+        {
+            if (disposing)
+            {
+                // cleanup
+            }
+
+            isAsyncDisposed = true;
+        }
+
+        return ValueTask.CompletedTask;
+    }
+
+    #endregion
+
+    #region Properties, Indexers
+
+    [Parameter(CaptureUnmatchedValues = true)] public Dictionary<string, object> AdditionalAttributes { get; set; } = default!;
+
+    /// <summary>
+    /// Gets or sets the CSS class.
+    /// <para>
+    /// Default value is <see langword="null" />.
+    /// </para>
+    /// </summary>
+    [AddedVersion("1.0.0")]
+    [DefaultValue(null)]
+    [Description("Gets or sets the CSS class.")]
+    [Parameter]
+    public string? Class { get; set; }
+
+    protected virtual string? ClassNames => Class;
+
+    /// <summary>
+    /// Gets or sets the associated <see cref="ElementReference" />.
+    /// <para>
+    /// May be <see langword="null" />, if accessed before the component is rendered.
+    /// </para>
+    /// </summary>
+    [DisallowNull]
+    public ElementReference? Element { get; set; }
+
+    /// <summary>
+    /// Gets or sets the ID. If not set, a unique ID will be generated.
+    /// <para>
+    /// Default value is <see langword="null" />.
+    /// </para>
+    /// </summary>
+    [AddedVersion("1.0.0")]
+    [DefaultValue(null)]
+    [Description("Gets or sets the ID. If not set, a unique ID will be generated.")]
+    [Parameter]
+    public string? Id { get; set; }
+
+    protected bool IsFirstRenderComplete { get; private set; }
+
+    [Inject] protected IJSRuntime JSRuntime { get; set; } = default!;
+
+    /// <summary>
+    /// Gets or sets the CSS style.
+    /// <para>
+    /// Default value is <see langword="null" />.
+    /// </para>
+    /// </summary>
+    [AddedVersion("1.0.0")]
+    [DefaultValue(null)]
+    [Description("Gets or sets the CSS style.")]
+    [Parameter]
+    public string? Style { get; set; }
+
+    protected virtual string? StyleNames => Style;
+
+    #endregion
+
+    #region Other
+
+    ~BlazorExpressLayoutComponentCore()
+    {
+        Dispose(false);
+    }
+
+    #endregion
+}