Update packages, add DataUrlDecoder.Decode extension method (#298)

## Target
<!--
  Why are you making this change?
 -->
Update packages, add DataUrlDecoder.Decode extension method
#### Open Questions
<!-- OPTIONAL
- [ ] Use the GitHub checklists to spark discussion on issues that may
arise from your approach. Please tick the box and explain your answer.
-->

## Checklist
<!--
It serves as a gentle reminder for common tasks. Confirm it's done and
check everything that applies.
-->
- [ ] Documentation updated
- [x] Tests cover new or modified code
- [x] I have performed a self-review of my own code
- [x] I have commented my code, particularly in hard-to-understand areas
- [ ] I have made corresponding changes to the documentation
- [x] My changes generate no new warnings
- [ ] New dependencies added
- [ ] Includes breaking changes
- [x] Version bumped

## Visuals
<!-- OPTIONAL
Show results both before and after this change. When the output changes,
it can be a screenshot of a trace, metric, or log illustrating the
change.
-->

.github/workflows/cd.yml

@@ -56,8 +56,24 @@ jobs:
         files: coverage.net6.0.cobertura.xml, coverage.net7.0.cobertura.xml, coverage.net8.0.cobertura.xml
         fail_ci_if_error: true
         verbose: true
-
-     # publishes Blazor project to the release-folder
+
+    - name: Wait for Exit Code 1 for Cropper.Blazor.Sitemap.Generator project
+      run: |
+        dotnet run -c Release
+      working-directory: src/Cropper.Blazor/Cropper.Blazor.Sitemap.Generator
+
+    - name: Check if sitemap.xml File Exists
+      run: |
+        filePath="./sitemap.xml"
+        if [ -f "$filePath" ]; then
+          echo "sitemap.xml file exists"
+        else
+          echo "File does not exist"
+          exit 1
+        fi
+      working-directory: src/Cropper.Blazor/Client/wwwroot
+
+      # publishes Blazor project to the release-folder
     - name: Publish .NET Core Project
       run: dotnet publish ./src/Cropper.Blazor/Client/Cropper.Blazor.Client.csproj -c Release --output release --nologo
 
@@ -119,6 +135,8 @@ jobs:
   demo-projects-build:
     name: Build Demo Projects
     runs-on: windows-latest
+    env: 
+     JAVA_HOME: '/home/runner/android-sdk'
 
     steps:
     - uses: actions/checkout@v3
@@ -131,7 +149,23 @@ jobs:
             6.0.x
             7.0.x
             8.0.x
-
+            
+    - name: Cache JDK
+      id: cache-jdk
+      uses: actions/cache@v3
+      with:
+        path: ${{ env.JAVA_HOME }}
+        key: ${{ runner.os }}-jdk-11
+        restore-keys: |
+            ${{ runner.os }}-jdk-
+
+    - name: Setup Java JDK
+      if: steps.cache-jdk.outputs.cache-hit != 'true'
+      uses: actions/[email protected]
+      with:
+        distribution: 'microsoft'
+        java-version: 11
+
     - name: search workloads
       run: dotnet workload search
 

examples/Cropper.Blazor.MAUI.Net7/Cropper.Blazor.MAUI.Net7.csproj

@@ -52,7 +52,7 @@
     <ItemGroup>
         <PackageReference Include="Microsoft.Extensions.Logging.Debug" Version="7.0.0" />
 		<PackageReference Include="Microsoft.Extensions.Logging.Abstractions" VersionOverride="7.0.1" Version="7.0.1" />
-        <PackageReference Include="MudBlazor" Version="6.11.0" />
+        <PackageReference Include="MudBlazor" Version="6.11.1" />
     </ItemGroup>
 
     <ItemGroup>

examples/Cropper.Blazor.MAUI.Net8/Cropper.Blazor.MAUI.Net8.csproj

@@ -62,7 +62,7 @@
 		<PackageReference Include="Microsoft.Maui.Controls.Compatibility" Version="$(MauiVersion)" />
 		<PackageReference Include="Microsoft.AspNetCore.Components.WebView.Maui" Version="$(MauiVersion)" />
 		<PackageReference Include="Microsoft.Extensions.Logging.Debug" Version="8.0.0" />
-		<PackageReference Include="MudBlazor" Version="6.11.0" />
+		<PackageReference Include="MudBlazor" Version="6.11.1" />
 	</ItemGroup>
 
 	<ItemGroup>

examples/Cropper.Blazor.Server.Net6/Cropper.Blazor.Server.Net6.csproj

@@ -7,7 +7,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="MudBlazor" Version="6.11.0" />
+    <PackageReference Include="MudBlazor" Version="6.11.1" />
   </ItemGroup>
 
   <ItemGroup>

examples/Cropper.Blazor.Server.Net7/Cropper.Blazor.Server.Net7.csproj

@@ -7,7 +7,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="MudBlazor" Version="6.11.0" />
+    <PackageReference Include="MudBlazor" Version="6.11.1" />
   </ItemGroup>
 
   <ItemGroup>

examples/Cropper.Blazor.Server.Net8/Cropper.Blazor.Server.Net8.csproj

@@ -1,4 +1,4 @@
-<Project Sdk="Microsoft.NET.Sdk.Web">
+<Project Sdk="Microsoft.NET.Sdk.Web">
 
   <PropertyGroup>
     <TargetFramework>net8.0</TargetFramework>
@@ -7,7 +7,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="MudBlazor" Version="6.11.0" />
+    <PackageReference Include="MudBlazor" Version="6.11.1" />
   </ItemGroup>
 
 	<ItemGroup>

examples/Cropper.MVC.With.Blazor.Server.Net7/Cropper.MVC.With.Blazor.Server.Net7.csproj

@@ -9,7 +9,7 @@
 	</ItemGroup>
 
 	<ItemGroup>
-		<PackageReference Include="MudBlazor" Version="6.11.0" />
+		<PackageReference Include="MudBlazor" Version="6.11.1" />
 	</ItemGroup>
 
 </Project>

src/Cropper.Blazor/Client/App.razor

@@ -1,7 +1,7 @@
 <Router AppAssembly="@typeof(App).Assembly">
     <Found Context="routeData">
         <RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
-        <FocusOnNavigate RouteData="@routeData" Selector="h1" />
+        <FocusOnNavigate RouteData="@routeData" Selector=".button-gradient" />
     </Found>
 
     <NotFound>

src/Cropper.Blazor/Client/Components/Docs/ApiLink.cs

@@ -28,7 +28,7 @@ private static string GetComponentName(Type type)
             return component;
         }
 
-        public static Type GetTypeFromComponentLink(string component)
+        public static Type? GetTypeFromComponentLink(string component)
         {
             if (component.Contains('#') == true)
             {
@@ -37,7 +37,7 @@ public static Type GetTypeFromComponentLink(string component)
 
             if (string.IsNullOrEmpty(component))
             {
-                throw new ArgumentException(nameof(component));
+                return null;
             }
 
             var assembly = typeof(CropperComponent).Assembly;
@@ -58,7 +58,7 @@ public static Type GetTypeFromComponentLink(string component)
                 }
             }
 
-            throw new ArgumentNullException(nameof(component));
+            return null;
         }
 
         public static string GetContextType(this Type type)

src/Cropper.Blazor/Client/Components/Docs/DocsApi.razor

@@ -10,42 +10,42 @@
 @using Cropper.Blazor.Shared.Extensions;
 
 <DocsPage>
-    @if (!IsContract)
-    {
-        <link rel="canonical" Href="@ApiLink.GetComponentLinkFor(Type)" />
-        <DocsPageSection api-link-section>
-            <SectionHeader Title="Pages" TitleClass="mt-3" />
-            <div class="docs-page-apilinks">
-                <ul class="my-2">
-                    <li>
-                        <MudLink Class="disabled"
-                                 UserAttributes="@(new Dictionary<string, object>(){ {"rel", "noopener"} })"
-                                 Href="#">
-                            <CodeInline>@Type.GetTypeDisplayName()</CodeInline>
-                        </MudLink>
-                    </li>
-                </ul>
-            </div>
-        </DocsPageSection>
-    }
-    else
-    {
-        <MudText Typo="Typo.h5" Class="mt-3">
-            @if (Type.IsEnum)
-            {
-                <div>
-                    Enum <b>@TypeNameHelper.GetTypeDisplay(Type, false, true)</b>
-                </div>
-            }
-            else
-            {
-                <div>
-                    Contract <b>@TypeNameHelper.GetTypeDisplay(Type, false, true)</b>
-                </div>
-            }
-        </MudText>
-    }
+    <DocsPageHeader Title="Cropper Component API" TitleTypo="@Typo.h4" />
     <DocsPageContent>
+        @if (!IsContract)
+        {
+            <link rel="canonical" Href="@ApiLink.GetComponentLinkFor(Type)" />
+            <DocsPageSection api-link-section>
+                <SectionHeader Title="Pages" TitleClass="mt-3" />
+                <div class="docs-page-apilinks">
+                    <ul class="my-2">
+                        <li>
+                            <MudLink UserAttributes="@(new Dictionary<string, object>(){ {"rel", "noopener"} })"
+                                     Href="examples/cropperusage">
+                                <CodeInline>@Type.GetTypeDisplayName()</CodeInline>
+                                </MudLink>
+                            </li>
+                        </ul>
+                    </div>
+                </DocsPageSection>
+        }
+        else
+        {
+            <MudText Typo="Typo.h5" Class="mt-3">
+                @if (Type.IsEnum)
+                {
+                    <div>
+                        Enum <b>@TypeNameHelper.GetTypeDisplay(Type, false, true)</b>
+                    </div>
+                }
+                else
+                {
+                    <div>
+                        Contract <b>@TypeNameHelper.GetTypeDisplay(Type, false, true)</b>
+                    </div>
+                }
+            </MudText>
+        }
 
         @{
             // save as lists to speed up displaying the page

src/Cropper.Blazor/Client/Components/Docs/DocsPage.razor

@@ -1,11 +1,27 @@
-<MudMainContent Class="mb-16">
+<MudMainContent Class="mb-8">
     <MudContainer MaxWidth="MaxWidth.Large">
         <div id="docspage" class="docs-page">
             <CascadingValue Value="this" IsFixed>
                 @ChildContent
             </CascadingValue>
         </div>
     </MudContainer>
+    @if (DisplayFooter)
+    {
+        <MudContainer MaxWidth="MaxWidth.Large" Class="mt-16">
+            <Footer />
+        </MudContainer>
+    }
+    else
+    {
+        <MudContainer MaxWidth="MaxWidth.Large" Class="mt-8">
+            <MudToolBar DisableGutters="true" Dense="true" WrapContent="true">
+                <MudText Typo="Typo.body1">Copyright © 2022-@DateTime.Now.Year <span class="text-gradient">Cropper.Blazor</span></MudText>
+                <MudSpacer />
+                <MudText Typo="Typo.body1">Powered by .NET @Environment.Version.ToString()</MudText>
+                </MudToolBar>
+            </MudContainer>
+    }
     <MudDrawer Class="docs-page-content-navigation-drawer" @bind-Open="_contentDrawerOpen" Breakpoint="Breakpoint.Lg" Anchor="Anchor.End" ClipMode="DrawerClipMode.Always" Elevation="0" Color="Color.Transparent">
         @if (_displayView)
         {

src/Cropper.Blazor/Client/Components/Docs/DocsPage.razor.cs

@@ -1,7 +1,6 @@
 using System.Diagnostics;
 using Cropper.Blazor.Client.Services;
 using Microsoft.AspNetCore.Components;
-using Cropper.Blazor.Client.Models;
 using MudBlazor;
 using MudBlazor.Interfaces;
 
@@ -19,6 +18,7 @@ public partial class DocsPage : ComponentBase
         [Inject] NavigationManager NavigationManager { get; set; }
         [Inject] private IRenderQueueService RenderQueue { get; set; }
         [Parameter] public RenderFragment ChildContent { get; set; }
+        [Parameter] public bool DisplayFooter { get; set; }
 
         private bool _contentDrawerOpen = true;
         public event Action<Stopwatch> Rendered;

src/Cropper.Blazor/Client/Components/Docs/DocsPageHeader.razor

@@ -14,7 +14,7 @@
 else
 {
     <div class="docs-page-header mt-6 mb-12">
-        <MudText Typo="@Typo.h3">@Title</MudText>
+        <MudText Typo="@TitleTypo">@Title</MudText>
         <MudText>@GetSubTitle() @Description</MudText>
     </div>
 }
@@ -25,9 +25,10 @@ else
     [Parameter] public string SubTitle { get; set; }
     [Parameter] public RenderFragment Description { get; set; }
     [Parameter] public RenderFragment SpecialHeaderContent { get; set; }
+    [Parameter] public Typo TitleTypo { get; set; } = Typo.h3;
 
 
-    string GetTitle() => $"{Title} - MudBlazor";
+    string GetTitle() => $"{Title} - Cropper.Blazor";
 
     string GetSubTitle()
     {

src/Cropper.Blazor/Client/Components/Docs/SectionContent.razor

@@ -10,40 +10,40 @@
 
 @if ((Codes != null || ChildContent != null) && !IsOnlySingleSectionCode)
 {
-    <div class="@Classname">
+    <div class="@Classname" style="@Style">
         @if (Codes != null || ChildContent != null)
         {
-            <MudToolBar Class="@ToolbarClassname">
-                <MudButtonGroup Color="Color.Primary" Class="mud-width-full"
-                                Variant="Variant.Text" VerticalAlign="IsVerticalAlign"
-                                Style="border-radius: 8px 8px 0 0">
-                    @if (Codes != null)
+            <MudToolBar Class="@ToolbarClassname" WrapContent="IsVerticalAlign">
+                @if (Codes != null)
+                {
+                    @foreach (var codefile in Codes)
                     {
-                        @foreach (var codefile in Codes)
-                        {
-                            <MudButton Class="@GetActiveCode(codefile.code)"
-                                       OnClick="@(() => SetActiveCode(codefile.code))"
-                                       Style="word-break: break-word;"
-                                       Size="Size.Small">
-                                @codefile.title
-                            </MudButton>
-                        }
-                    }
-
-                    @if (!IsVerticalAlign)
-                    {
-                        <MudSpacer />
-                    }
-
-                    @if (HasCode && ChildContent != null)
-                    {
-                        <MudButton OnClick="OnShowCode"
-                                   StartIcon="@(ShowCode ? @Icons.Material.Rounded.CodeOff : Icons.Material.Rounded.Code)"
+                        <MudButton Class="@GetActiveCode(codefile.code)"
+                                   Variant="@(IsVerticalAlign ? Variant.Filled : Variant.Text)"
+                                   Color="@(IsVerticalAlign ? Color.Primary : Color.Default)"
+                                   FullWidth="IsVerticalAlign"
+                                   OnClick="@(() => SetActiveCode(codefile.code))"
+                                   Style="word-break: break-word;"
                                    Size="Size.Small">
-                            @(ShowCode ? "Hide code" : "Show code")
+                            @codefile.title
                         </MudButton>
                     }
-                </MudButtonGroup>
+                }
+
+                @if (!IsVerticalAlign)
+                {
+                    <MudSpacer />
+                }
+
+                @if (HasCode && ChildContent != null)
+                {
+                    <MudButton OnClick="OnShowCode"
+                               FullWidth="IsVerticalAlign"
+                               StartIcon="@(ShowCode ? @Icons.Material.Rounded.CodeOff : Icons.Material.Rounded.Code)"
+                               Size="Size.Small">
+                        @(ShowCode ? "Hide code" : "Show code")
+                    </MudButton>
+                }
             </MudToolBar>
         }
         @if (ChildContent != null)

src/Cropper.Blazor/Client/Components/Docs/SectionContent.razor.cs

@@ -42,6 +42,7 @@ public partial class SectionContent : IBrowserViewportObserver
             .AddClass(ShowCodeClass)
             .Build();
 
+    [Parameter] public string Style { get; set; } = null!;
     [Parameter] public string Class { get; set; } = string.Empty;
     [Parameter] public string ShowCodeClass { get; set; } = string.Empty;
     [Parameter] public bool DarkenBackground { get; set; }
@@ -118,6 +119,12 @@ RenderFragment CodeComponent(string code) => builder =>
         try
         {
             string? key = typeof(SectionContent).Assembly.GetManifestResourceNames().FirstOrDefault(x => x.Contains($".{code}Code.html"));
+
+            if (key is null)
+            {
+                throw new KeyNotFoundException($"'.{code}Code.html' code not exist");
+            }
+
             using var stream = typeof(SectionContent).Assembly.GetManifestResourceStream(key!);
             using var reader = new StreamReader(stream!);
             var read = reader.ReadToEnd();
@@ -143,7 +150,7 @@ RenderFragment CodeComponent(string code) => builder =>
         }
         catch (Exception ex)
         {
-            Console.WriteLine(ex.StackTrace);
+            Console.WriteLine($"{ex.Message}, {ex.StackTrace}");
         }
     };