Merge branch 'refs/heads/master' into features/api-docs

CONTRIBUTING.md

@@ -22,10 +22,30 @@ with the project's goals or because someone else is already working on it.
 
 1. Fork and clone the repository
 2. Run `npm install` to install dependencies
-3. Run `dotnet build Ignis.sln` to build the project
+3. Run `dotnet build ./Ignis.sln -c Release` to build the project
 
 This should be all you need to get started. If you run into any issues, please let us know by opening an issue.
 
+#### Generated content
+
+Both the `Ignis.Components.HeroIcons` and the `Ignis.Website` projects contain generated content.
+
+The `Ignis.Components.HeroIcons` project contains the generated C# code for the HeroIcons. This code is generated from
+the official [heroicons repository](https://github.com/tailwindlabs/heroicons) , which you can run with the following
+command:
+
+```shell
+dotnet run --project ./tools/Ignis.Components.HeroIcons.Generator
+```
+
+The `Ignis.Website` project contains the generated documentation for the Ignis repository. This documentation is
+generated from the markdown files in the [docs](docs) directory. You can generate the documentation with the following
+command:
+
+```shell
+dotnet run --project ./tools/Ignis.Website.Generator
+```
+
 ## Coding standards
 
 We use [Husky.Net](https://github.com/alirezanet/Husky.Net) to enforce coding standards. As long as you followed the

packages/Tailwind/Ignis.Components.HeadlessUI/Aria/AriaPopupExtensions.cs

@@ -1,4 +1,5 @@
 using Microsoft.AspNetCore.Components.Web;
+using Microsoft.JSInterop;
 
 namespace Ignis.Components.HeadlessUI.Aria;
 
@@ -11,6 +12,7 @@ public static void SetActiveDescendant(this IAriaPopup popup, IAriaDescendant de
         if (isActive)
         {
             popup.ActiveDescendant = descendant;
+            _ = ScrollIntoViewAsync(popup);
         }
         else if (popup.ActiveDescendant == descendant)
         {
@@ -60,4 +62,15 @@ public static void OnKeyDown(this IAriaPopup popup, KeyboardEventArgs eventArgs)
                 }
         }
     }
+
+    private static readonly object ScrollOptions = new { Behavior = "smooth", Block = "nearest" };
+
+    private static async Task ScrollIntoViewAsync(IAriaPopup popup)
+    {
+        var id = popup.GetId(popup.ActiveDescendant);
+        if (id == null) return;
+
+        await using var element = await popup.JSRuntime.InvokeAsync<IJSObjectReference>("document.getElementById", id);
+        await element.InvokeVoidAsync("scrollIntoView", ScrollOptions);
+    }
 }

packages/Tailwind/Ignis.Components.HeadlessUI/Aria/IAriaPopup.cs

@@ -1,4 +1,5 @@
 using Ignis.Components.Web;
+using Microsoft.JSInterop;
 
 namespace Ignis.Components.HeadlessUI.Aria;
 
@@ -47,4 +48,7 @@ public interface IAriaPopup : IAriaControl, IAriaLabeled, IOpenClose, IWithTrans
     /// The button which controls the popup.
     /// </summary>
     IAriaComponentPart? Button { get; set; }
+
+    // ReSharper disable once InconsistentNaming
+    internal IJSRuntime JSRuntime { get; }
 }

packages/Tailwind/Ignis.Components.HeadlessUI/Ignis.Components.HeadlessUI.csproj

@@ -16,7 +16,7 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
     <PackageOutputPath>..\..\..\nuget</PackageOutputPath>
-    <NoWarn>BL0007</NoWarn>
+    <NoWarn>BL0007,MA0004</NoWarn>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
   </PropertyGroup>